3. Guidelines for authors and editors

General methodology

The glossary objective –as the whole project undertone- pursues to meet the different points of view, here with regard to specific voices. It is well known that in many cases there are polysemy, in other cases we have to deal with theoretical terms, which clarified allow us to understand  every theory better,that is to say, every point of view. On the other hand, problems are seen, which from every point of view are felt different. Therefore, the decided methodology for the glossary means an elaboration in which all members may participate in every article but assuming responsibilities –distributed among members- with regard to the edition work. Specifically:
  1. All members are potential authors of ENTRIES for every proposed voice (although in the praxis authors will confine themselves to those voices appealing their perspectives, or the ones they can). For every voice the right column will be reserved for new entries.
  2. The EDITOR (one for every voice) will take the responsibility to incorporate every entry into the definitive article in a structured and non redundant manner. For this purpose, the left column of every voice will be used. This is probably a main difference –besides its object- between this glossary and Wikipedia. The editor may –at the same time- ask the contributors to specify here and there; to improve the text; to add references… In many cases (specially at early stages) the editor is also the main or the unique contributor to the article.
  3. For every article, a discussion frame will be opened, where members may do comments, critics, suggestions, questions to the actual entries, etc. This space is located at the bottom of every voice, in the area which the system calls “comments”.
  4. Every article will be edited in both SPANISH and ENGLISH. It will also be  pointed out the most used and nearest voices in French and German (although not developed in these languages).
  5. To compile the glossary we have this SYSTEM to our disposal , in which every article corresponds to a different page that can be accessed through the indexes, hyperlinks or the searching tool.


How can an article be accessed?


There is a web-page for every created article, which corresponds with the Spanish version. This page belongs to the main page “glosario”, and it has associated a subpage, corresponding with the English version. The general structure of the web-site can be seen in the sitemap, which can be accessed in the navigation board.

Figure 1
The index has been created (in Spanish and english) to access directly into the articles. If a specific voice shown in the index does not have an associated link, it means that such article has been proposed but is not yet been created for edition. All actually opened articles are reflected alphabetically in the sitemap (expanding the page named “glosario”), or at the bottom of the main page (“glosario”) by pressing the indication “subpages”.

Hyperlinks will also be included among articles whenever an open voice is mentioned in other. Finally, using the “Search site” Tool in the upper right corner, any voice or character string may be searched within the glossary-site.

The reader will always find OTHER NAVIGATION FACILITIES on the left side of any page:.:

               Navigation tool (to access any of the main pages)

               Recent site activity, where the reader may access directly to the page, in which the last registered changes in the glossary-site have been done.

               E-mail addresses to contact with the coordination board, and links to BITrum web-sites.


General distribution of an article page


As headline of every article (in its Spanish version) the reader will find the Spanish and English voices separated by a double vertical bar ‘||’ (however, the English version is only headed by its corresponding voice). Underneath this heading, the reader will find the columns corresponding to the article in itself (the one on the left) and the entries of authors. The first one should only be edited by the corresponding editor, while the rest of the members are invited to contribute in the entries column.
Figure 2



How can be accessed the editing tools?


Since the access to the glossary is now free, editors and authors will only have access to edition tools if they are identified. There is a link to the identification page at the bottom left side of any page, named “sign-in” or “acceder”. For those wishing to edit before recovering their own passwords a generic user has been created. It is available in the private area or can be obtained under request to coordinators (send mail).



Figure 3: How to sign in for accessing to editing tools (detail of the bottom of a page)


How to do an entry? (Authors)


Whenever an author wants to do a new entry:

1.             After the desired page is reached, it has to be opened with the edition tools (pressing the “edit page” button in the upper tool bar of the page –only visible for site collaborators).

2.             The new entry should be done just below the former ones. Before entering it, the blue explicative paragraph and the following lines until the column end should be copied and pasted at the bottom, so they are to disposal for a later entry. Subsequently, the fields [name], [date] and [text] has to be fulfilled by the author (using the author’s name and the date in which the entry has been done).

In order to not modify the text formats of the article, the text of the entry should be entered without format. Notice that whenever a text is copied from a text editor, the format is usually modified in the destination when it is directly pasted. To avoid it you can follow –for example- the next steps:

a)             Open a notebook or similar editor (without format);

b)             Copy the desired content in the original editor and paste it in the notebook (or similar editor);

c)             Copy the selected text in the notebook (or similar editor) and paste it in the open article in edition mode.

 

Figure 4
 
In the lower side of every page there is a “comments” area, which will be used for every article as a discussion forum with regard to the controversies held around the article.


How can an article be edited? (Editors)


The central column is reserved for article edition. This column is divided in three sections:

1.            The article heading containing:

a)             name and e-mail address of the editor;

b)             the contributions already incorporated into the article, designated by the author name and the entry date, as they are indicated in the entries column (e.g. Al Hadithi (21/02/09), Capurro (15/03/09));

c)              Usage domain (disciplines or theories in which the term is used);

d)             Type (concept, metaphore, theory, author, tool);

e)             French and German equivalent voices.

2.            The article it self, in which the editor will incorporate (structured and without redundancies) the entries that are leaved in the right column.

3.             A space for the bibliographic references, for which the indicated format for articles, books and electronic publications should be followed.
 
Any metacomment (e.g. about the degree of development of an entry; to notice that the article is first edited in the other language, etc) should be included between brackets "[...]", so that it can be easily distinguished from the text in which the article is properly developed.
 
Figure 5

Direct article edition

In case the editor directly edits the article in the article edition area (central column) this will be considered as a first entry authored by the editor. In order to record this in the entries area:
 
1)  The paragraphs for a new entry (starting with blue fonts) until "[Entry text]" should be copied and pasted at the column bottom.
2)  The upper blue explicative paragraph (in blue) should be erased.
3)  "Name" will be changed by the author's name (in this case the editor) followed by the date in which the article has been edited.
4)  The paragraph: "[Entry text]" will be substituted by:

[It corresponds with the first version of the article, which is now showed in the left column.]

     Or in case of the Spanish edition of the article:

[Corresponde con la primera versión del artículo, ahora recogido en la columna de la izquierda.]
Next, the name of the author (in this case also editor) will be added within the heading data table of the article area in the row of "incorporated contributions" (where authorship is registered), followed by edition data in brackets.
 

Edition only in one language

 

For articles being first only edited in English or in Spanish, the editor will include the following comment in the page corresponding to the language in which is not being edited, just in the place of the paragraph: "{article text}":
  • If the article is first being edited in English (thus the comment should be placed in the Spanish version page):
[Este artículo esta siendo editado en inglés. Será traducido en cuanto se alcance una versión estable del mismo. Será, no obstante, bienvenida cualquier entrada, comentario o discusión en castellano acerca de esta voz –vertidas sobre esta página-.]
  • If the article is first being edited in Spanish (thus the comment should be placed in the English version page):

[This article is now being edited in Spanish. It will be translated to English when a stable version is reached. English entries, comments or discussion -within this page- will be very welcomed.]

How to be aware of changes?

Editors should subscribe to changes in their articles in order to follow up eventual comments and contributions. Once subscribed to changes in an article, the system will alert you by e-mail of any contributed text or change in the article page. Please don't forget to subscribe both to the english and spanish pages of each of your edited articles.

To subscribe to the changes of one article you have to be located in its corresponding page and:

1st) select “more actions” in the upper tool bar

2nd) select “subscribe to changes in the page”

Figure 6

Management and activity visualization

To facilitate updated access to the current state of any voice, in the "management" section ("4. Administratio") you may access from any point in the glossary (within the navigation box "Glosarium BITri" located at the link column).
 

Figure 7
 

How to add a new article into the Glossary?

If you would like to add/propose a new article to the glossary, there is a data form in the section for proposing new articles (8. Propositio articulōrum), which allow to store in a consultable data bank of proposals.

When the coordination board will assign an editor to the new article –according to previous proposals-, the new article-page will then be created for further edition within the system.

 
Ċ
José María Díaz Nafría,
Jul 31, 2009, 7:56 AM
Comments