Transparency-Accountability/Wiki-Style-Guide: Difference between revisions

From DLF Wiki
Jump to navigation Jump to search
No edit summary
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
=Wiki Style Guide, Editing Standards and Tips=
[[Image:Rta3.png|800px|link=Transparency-Accountability]]
==Wiki Ownership==
==<span style="color:#004d66"><span style="font-family:Verdana>Wiki Ownership</span></span>==
Keep in mind that the wiki belongs to the Digital Library Federation proper.  The left-hand menus direct users to resources of the broader organization rather than the Government Records Transparency and Accountability Interest Group portion of the wiki.
Keep in mind that the wiki belongs to the Digital Library Federation proper.  The left-hand menus direct users to resources of the broader organization rather than the Government Records Transparency and Accountability Interest Group portion of the wiki.


For instance, the DLF logo to the upper left of every wiki page is linked to the DLF wiki homepage: '''[[Main_Page]]'''
For instance, the DLF logo to the upper left of every wiki page is linked to the DLF wiki homepage: '''[[Main_Page]]'''


==Government Records Transparency and Accountability Interest Group Homepage==
==<span style="color:#004d66"><span style="font-family:Verdana>Government Records Transparency and Accountability Interest Group Homepage</span></span>==
The effective wiki homepage for the Government Records Transparency and Accountability Interest Group is '''[[Transparency-Accountability]]'''.  The 'external' url of this page, https://wiki.diglib.org/Transparency-Accountability is inextricably linked to the decision to name the page '''[[Transparency-Accountability]]'''.  The choice of page names and resulting urls are directly linked, and therefore page naming conventions are useful in creating attractive and logical urls.
The effective wiki homepage for the Government Records Transparency and Accountability Interest Group is '''[[Transparency-Accountability]]'''.  The 'external' url of this page, https://wiki.diglib.org/Transparency-Accountability is inextricably linked to the decision to name the page '''[[Transparency-Accountability]]'''.  The choice of page names and resulting urls are directly linked, and therefore page naming conventions are useful in creating attractive and logical urls.
==Page Creation, Naming Conventions and Indexing==
==<span style="color:#004d66"><span style="font-family:Verdana>Page Creation, Naming Conventions and Indexing</span></span>==
===Page Creation===
===Page Creation===
To create a page in the [[Transparency-Accountability]] portion of the wiki, you must search for a non-existant page.  All pages should include Transparency-Accountability/ in their names as is explained below in the section on Page Naming Conventions.  The wiki, upon a search that fails to locate a page with a searched for name, will allow the user to create a page with that name by providing a link.
To create a page in the [[Transparency-Accountability]] portion of the wiki, you must search for a non-existant page.  All pages should include Transparency-Accountability/ in their names as is explained below in the section on Page Naming Conventions.  The wiki, upon a search that fails to locate a page with a searched for name, will allow the user to create a page with that name by providing a link.
Line 33: Line 33:
#*The page is not actually created until you add text and save the changes.  Prior to making the first save, double check the page name to ensure it follows the Naming Conventions above
#*The page is not actually created until you add text and save the changes.  Prior to making the first save, double check the page name to ensure it follows the Naming Conventions above
# Finally, edit the '''[[Transparency-Accountability/Page-Index]]''' page to place a link to your newly created page in the list, alphabetically
# Finally, edit the '''[[Transparency-Accountability/Page-Index]]''' page to place a link to your newly created page in the list, alphabetically
==Homepage Maintenance==
==<span style="color:#004d66"><span style="font-family:Verdana>Homepage Maintenance</span></span>==
The '''[[Transparency-Accountability]]''' homepage is a resource to current members, a recruitment tool for potential members, and a resource to the citizenry.  It therefore needs to be '''Current, Comprehensive''' and '''Concise'''.  Let it not be lost that the last two of these characteristics are in conflict, and therefore a balance must be struck.
The '''[[Transparency-Accountability]]''' homepage is a resource to current members, a recruitment tool for potential members, and a resource to the citizenry.  It therefore needs to be '''Current, Comprehensive''' and '''Concise'''.  Let it not be lost that the last two of these characteristics are in conflict, and therefore a balance must be struck.
===Currency===
===Currency===
Line 57: Line 57:
# Lengthy descriptions and details ought to be shunted when possible
# Lengthy descriptions and details ought to be shunted when possible
#* (see '''[[Transparency-Accountability/Wiki-Style-Guide#Shunting]]''' below)
#* (see '''[[Transparency-Accountability/Wiki-Style-Guide#Shunting]]''' below)
==<span style="color:#004d66"><span style="font-family:Verdana>Graphics</span></span>==
[[Image:Rta.png|thumb|right|DLF Graphic|link=Transparency-Accountability]]
===Banner Graphic===
The banner graphic should appear across the top of every page, as it does on this page, and serve as a link to the '''[[Transparency-Accountability]]''' homepage, for quick navigation purposes
===DLF Graphic===
The DLF created graphic (pictured to the right) for the group can appear where it may enhance a page or fill empty space.  Feel free to set the image as frameless, justify it to the right, and link it, like the banner image, to the '''[[Transparency-Accountability]]''' homepage
==<span style="color:#004d66"><span style="font-family:Verdana>Section Font Style</span></span>==
Top level sections ought to have their font style, which defaults to black Times New Roman, changed so that the font-family is <span style="font-family:Verdana>Verdana</span>, and the hex color of the font is <span style="color:#004d66">#004d66</span>, matching the color of the DLF Grahpic above
==<span style="color:#004d66"><span style="font-family:Verdana>Shunting</span></span>==
''Shunting'' is a [https://en.wikipedia.org/wiki/Shunting_(rail) railroad term] describing activity where trains are broken into segments of related railcars and these segments are appropriately relocated to other tracks.


==Shunting==
In our context, we look to shunt content from the '''[[Transparency-Accountability]]''' homepage to other page(s) to keep the homepage '''Concise''' while leaving behind a short description of and link to the shunted content thereby keeping the '''[[Transparency-Accountability]]''' homepage '''Comprehensive'''
Shunting is a [https://en.wikipedia.org/wiki/Shunting_(rail) railroad term] describing activity where trains are broken into segments of related railcars and these segments are appropriately relocated to other tracks
===General Concept===
As the group's activities increase and time passes, content from the '''[[Transparency-Accountability]]''' homepage may need to be shunted off to existing or new pages
# Dated material ought to be shunted off to help keep the '''[[Transparency-Accountability]]''' homepage '''Current'''
# Lengthy descriptions and details can be shunted off to help keep the '''[[Transparency-Accountability]]''' homepage '''Concise'''
# Links to and short descriptions of shunted content can be retained on the '''[[Transparency-Accountability]]''' homepage to help keep it '''Comprehensive'''
===Example of Shunting===
====2017 Forum panel and working lunch====
In 2017, the group held a panel and a working lunch at the DLF Forum
* A detailed description of the activities comprised a section of the '''[[Transparency-Accountability]]''' homepage
====2018 Forum working lunch====
In 2018, another working lunch was held by the group at the DLF Forum
====Content Combined and Shunted====
Rather than adding more content to the '''[[Transparency-Accountability]]''' homepage, the descriptions of these events were shunted
# A page was created with the name '''[[Transparency-Accountability/Forums]]'''
#* A section of the page was named '''2018''' and the 2018 content was shunted there
#* A section of the page was named '''2017''' and the 2017 content was removed from the '''[[Transparency-Accountability]]''' homepage and shunted there
#* A general description of DLF Forum activities was added above the '''2017''' and '''2018''' sections
# Back on the '''[[Transparency-Accountability]]''' homepage
#* A link with a short description was retained redirecting user to shunted content
# When upcoming Forums approach, the pertinent details ought to be on the '''[[Transparency-Accountability]]''' homepage, but once they have passed, the recap ought to be shunted to a new section under the appropriate year on the '''[[Transparency-Accountability/Forums]]''' page
==<span style="color:#004d66"><span style="font-family:Verdana>Page Size</span></span>==
===Homepage===
Efforts should be made to try to keep the size of the '''[[Transparency-Accountability]]''' homepage to about 10k
===Index Pages===
Index pages, such as '''[[Transparency-Accountability/Minutes]]''' can be as long as necessary
===Shunted Content===
When possible, pages containing shunted content that are not index pages should be kept to around 4k
==<span style="color:#004d66"><span style="font-family:Verdana>Contacts</span></span>==
When listing contacts for individuals, limit identification to name and affiliated institution.  This should be enough for interested individuals to discover emails via a search

Latest revision as of 14:27, 20 December 2018

Wiki Ownership

Keep in mind that the wiki belongs to the Digital Library Federation proper. The left-hand menus direct users to resources of the broader organization rather than the Government Records Transparency and Accountability Interest Group portion of the wiki.

For instance, the DLF logo to the upper left of every wiki page is linked to the DLF wiki homepage: Main_Page

Government Records Transparency and Accountability Interest Group Homepage

The effective wiki homepage for the Government Records Transparency and Accountability Interest Group is Transparency-Accountability. The 'external' url of this page, https://wiki.diglib.org/Transparency-Accountability is inextricably linked to the decision to name the page Transparency-Accountability. The choice of page names and resulting urls are directly linked, and therefore page naming conventions are useful in creating attractive and logical urls.

Page Creation, Naming Conventions and Indexing

Page Creation

To create a page in the Transparency-Accountability portion of the wiki, you must search for a non-existant page. All pages should include Transparency-Accountability/ in their names as is explained below in the section on Page Naming Conventions. The wiki, upon a search that fails to locate a page with a searched for name, will allow the user to create a page with that name by providing a link.

Naming Conventions

There are three important conventions when naming pages

  1. Begin the page name with Transparency-Accountability/
    • The slash in the page name appears in the url like a directory, and Transparency-Accountability indicates our groups' "ownership" of the page
  2. Use dashes rather than spaces to separate words in page names
    • Spaces appear as underscores in links and urls such as with Main_Page, the aforementioned DLF wiki homepage. The dashes create more attractive and intuitive urls and internal links
  3. Try to minimize the number of words in the page name.

Additionally, the Transparency-Accountability/Page-Index is a great resource for reviewing previous page name choices, and may inform decisions as to whether a new page is even necessary

Page Indexing

Each newly created page should be indexed alphabetically at Transparency-Accountability/Page-Index. This page index is useful for determining where information ought to be located, in determining whether a new page ought to be created, and as a resource for page naming.

Example Page Creation

As an example, let us say we want to create a page called My New Page. The approach would be as follows:

  1. Check the Transparency-Accountability/Page-Index page to see whether a page already exists that fills the role of my desired page
    • We want to avoid creating 'duplicate' pages that could result information being inconsistently dispersed.
  2. Confirming the need for My New Page, we search for it in the upper right wiki search box as follows: Transparency-Accountability/My-New-Page
    • Note the dashes between words and the clear group ownership indicated by Transparency-Accountability/
  3. Having searched for a page that does not yet exist, we can expect to see the following option:
  4. Clicking on the Transparency-Accountability/My-New-Page link will jump you into the editor to add text
    • The page is not actually created until you add text and save the changes. Prior to making the first save, double check the page name to ensure it follows the Naming Conventions above
  5. Finally, edit the Transparency-Accountability/Page-Index page to place a link to your newly created page in the list, alphabetically

Homepage Maintenance

The Transparency-Accountability homepage is a resource to current members, a recruitment tool for potential members, and a resource to the citizenry. It therefore needs to be Current, Comprehensive and Concise. Let it not be lost that the last two of these characteristics are in conflict, and therefore a balance must be struck.

Currency

Keeping the Transparency-Accountability homepage Current helps to indicate the group is healthy and active

Meetings and Events

  1. Announcements for past meetings and events should be removed
  2. Announcements for upcoming meetings should be emphasized and appear "above the fold"
    • A schedule of upcoming meetings stretching months into the future not only allows members to plan but indicates to potential members a high level of organization

Shunting Dated Materials

Emphasizing activities from previous years on the homepage risks minimizing our activity level, those portions ought to be shunted off to new pages. (see Transparency-Accountability/Wiki-Style-Guide#Shunting below)

Comprehensiveness

In order to clearly indicate the breadth of our activities, the homepage ought to be Comprehensive

Activities

  1. All major aspects of our activities ought to be touched upon
    • In order to cover the breadth of activities, homepage descriptions ought to be Concise
  2. Lengthy descriptions and details ought to be shunted when possible

Conciseness

The Transparency-Accountability homepage ought not be Concise and not overwhelm visually or require copious scrolling

  1. The fewer the words, the more likely they are to be read
  2. Lengthy descriptions and details ought to be shunted when possible

Graphics

DLF Graphic

The banner graphic should appear across the top of every page, as it does on this page, and serve as a link to the Transparency-Accountability homepage, for quick navigation purposes

DLF Graphic

The DLF created graphic (pictured to the right) for the group can appear where it may enhance a page or fill empty space. Feel free to set the image as frameless, justify it to the right, and link it, like the banner image, to the Transparency-Accountability homepage

Section Font Style

Top level sections ought to have their font style, which defaults to black Times New Roman, changed so that the font-family is Verdana, and the hex color of the font is #004d66, matching the color of the DLF Grahpic above

Shunting

Shunting is a railroad term describing activity where trains are broken into segments of related railcars and these segments are appropriately relocated to other tracks.

In our context, we look to shunt content from the Transparency-Accountability homepage to other page(s) to keep the homepage Concise while leaving behind a short description of and link to the shunted content thereby keeping the Transparency-Accountability homepage Comprehensive

General Concept

As the group's activities increase and time passes, content from the Transparency-Accountability homepage may need to be shunted off to existing or new pages

  1. Dated material ought to be shunted off to help keep the Transparency-Accountability homepage Current
  2. Lengthy descriptions and details can be shunted off to help keep the Transparency-Accountability homepage Concise
  3. Links to and short descriptions of shunted content can be retained on the Transparency-Accountability homepage to help keep it Comprehensive

Example of Shunting

2017 Forum panel and working lunch

In 2017, the group held a panel and a working lunch at the DLF Forum

2018 Forum working lunch

In 2018, another working lunch was held by the group at the DLF Forum

Content Combined and Shunted

Rather than adding more content to the Transparency-Accountability homepage, the descriptions of these events were shunted

  1. A page was created with the name Transparency-Accountability/Forums
    • A section of the page was named 2018 and the 2018 content was shunted there
    • A section of the page was named 2017 and the 2017 content was removed from the Transparency-Accountability homepage and shunted there
    • A general description of DLF Forum activities was added above the 2017 and 2018 sections
  2. Back on the Transparency-Accountability homepage
    • A link with a short description was retained redirecting user to shunted content
  3. When upcoming Forums approach, the pertinent details ought to be on the Transparency-Accountability homepage, but once they have passed, the recap ought to be shunted to a new section under the appropriate year on the Transparency-Accountability/Forums page

Page Size

Homepage

Efforts should be made to try to keep the size of the Transparency-Accountability homepage to about 10k

Index Pages

Index pages, such as Transparency-Accountability/Minutes can be as long as necessary

Shunted Content

When possible, pages containing shunted content that are not index pages should be kept to around 4k

Contacts

When listing contacts for individuals, limit identification to name and affiliated institution. This should be enough for interested individuals to discover emails via a search