Help:Hands-on guidance for Opasnet

From Testiwiki
Revision as of 12:11, 6 April 2011 by Juha Villman (talk | contribs) (Added category: 'Help')
Jump to: navigation, search

Hands-on guidance for Opasnet offers practical hints for developing content and writing pages. It is based on real issues on Opasnet pages and the actual guidance that was given to improve the content. The idea is that if someone needed help with an issue, it is more likely that someone else would need the same help as well.

Scope

What are practical issues where users need help in Opasnet? What are the solutions?

Rationale

The idea is that if someone needed help with an issue, it is more likely that someone else would need the same help as well. The guidance is collected here, but it is also put to the page that is used as an example.

Result

Indetification of common currency for Plantlibra project (in Heande)

  • If possible, select a page type for all pages you edit if it has not been selected yet. Add a {{page type|moderator=Your username|stub=Yes}} to the beginning of the page. Currently, the most common page types are encyclopedia (465 pages), variable (316), method (193), nugget (122), study (60), assessment (38), lecture (17).
  • All pages should have a moderator. Keep a very low threshold to assign yourself as the moderator, especially if you created a page.
  • Put a page to Opasnet instead of Heande, unless it contains private or soon-to-be-published data.
  • Usually, start the headings from the ==Second level==. Use the =First level= only if you have subsections with clearly different topics on a page.
  • Try to put your content under the main headings that occur in theory at every page. However, don't be too worried about this, it can be fixed later.
    • Summary (to heading, it is the text before the first heading)
    • Scope (or question, what is the topic)
    • Definition (or rationale, how do we know the answer)
    • Result (or answer to the question)

Insulate:4.11.2010 Action group meeting agenda (in Heande

  • --# : Try to think about pages as long-living things. After a meeting the page about its agenda is no longer interesting. after new meetings, also the minutes of a meeting become less and less interesting. Therefore I suggest that the page could be named e.g. as "Insulate action group". It would contain agendas (which would change into minutes) of each meeting. Timely issues can be kept on the page, while the detailed old agendas and minutes can always be found from the history of the page. You can look at the page Opasnetin käyttökoulutus and its history to get the idea. --Jouni 04:34, 4 November 2010 (UTC)

Schedule for kick-off meeting (in Heande)

  • --# : Try to think of the name of the page from the audience's point of view. Think that you are writing a newspaper article. Most people are not from your project and they don't know what project you are thinking about. Put at least the project name to the title, also preferably the date and place. --Jouni 04:34, 4 November 2010 (UTC)