Link Creation Tutorial: Difference between revisions

From JoS Wiki
(initial creation)
 
(finished tutorial)
Line 13: Line 13:
* Any names or concepts which are not relevant
* Any names or concepts which are not relevant


Additional Tips


-Furthermore, to avoid repetition, links should only be made on the first occurrence of the subject, not every single time.  
* To avoid repetition, links should only be made on the first occurrence of the subject, not every single time.
* The link itself should be highlighting the unique aspect of the information being added, so readers know what the additional article contains. Links should be <u>both clear and specific</u>!
* Links should follow what a user expects to see, not something unrelated.
* Do not place a link to a name or subject found within another subject, except where there is no better option.


-The link itself should be highlighting the unique aspect of the information being added, so readers know what the additional article contains. Links should be <u>both clear and specific</u>!
 
When linking to a specific section within an article, the # key should be used. This is case specific! See the example below:
 
[[Gods A - B#AGARES/AGUARES]]
 
== Links within the JoS Wiki ==
The JoS Wiki features unique challenges relative to a normal Wiki site. In regards to links, there may be less that need to be made (due to a smaller amount of content), however we have to work around obstacles pertaining to protecting the original content. This may lead to links being created which may break the above rules in a way, for example. Other difficulties may result due to the imperfect page titles.
 
 
Any <u>links which were made by HPS Maxine, or any other original authors, should be left as they are</u>, for now. This is to protect the pre-existing unity of the pages, but also to protect her thought process within her writings.
 
 
For now, we should focus on the creation of new links which aid the interconnection of content, rather than trying to prune existing content.
 
'''Ideally, we will add 5 new links to every page''' (except for those which are very small or otherwise unsuitable). Although this is a small amount, this may still require a decent amount of research within the existing articles to ensure relevant content is linked!
 
View the [[Work Tasks|Work Groups]] to see a list of pages for this process.
 
 
From here, this will further aid our understanding of the content which is present on the Wiki, enabling us to make further changes without losing track of certain pages.

Revision as of 02:03, 24 August 2022

To transition the Wiki from a mere collection of pages into an interlinking hub of content, it is necessary to begin the creation of links between relevant pages. The goal is to enhance the information available to a reader, yet the reader should not be forced to click every link just to understand the original article.

Citing Wikipedia's Style, links should be made to

  • Articles that enhance comprehension of the original material
  • Proper names or other technical or slang terminology
  • Articles with additional, tangential information on a subject

Links should NOT be made to:

  • Simple or common phrases
  • Measurements or dates
  • Any names or concepts which are not relevant

Additional Tips

  • To avoid repetition, links should only be made on the first occurrence of the subject, not every single time.
  • The link itself should be highlighting the unique aspect of the information being added, so readers know what the additional article contains. Links should be both clear and specific!
  • Links should follow what a user expects to see, not something unrelated.
  • Do not place a link to a name or subject found within another subject, except where there is no better option.


When linking to a specific section within an article, the # key should be used. This is case specific! See the example below:

Gods A - B#AGARES/AGUARES

Links within the JoS Wiki

The JoS Wiki features unique challenges relative to a normal Wiki site. In regards to links, there may be less that need to be made (due to a smaller amount of content), however we have to work around obstacles pertaining to protecting the original content. This may lead to links being created which may break the above rules in a way, for example. Other difficulties may result due to the imperfect page titles.


Any links which were made by HPS Maxine, or any other original authors, should be left as they are, for now. This is to protect the pre-existing unity of the pages, but also to protect her thought process within her writings.


For now, we should focus on the creation of new links which aid the interconnection of content, rather than trying to prune existing content.

Ideally, we will add 5 new links to every page (except for those which are very small or otherwise unsuitable). Although this is a small amount, this may still require a decent amount of research within the existing articles to ensure relevant content is linked!

View the Work Groups to see a list of pages for this process.


From here, this will further aid our understanding of the content which is present on the Wiki, enabling us to make further changes without losing track of certain pages.