WikiSquad/Project/Improving the Wiki

Improving the Wiki
Workgroup	WikiSquad
Start date	Tue 28 February 2017
Contact	Ilja (talk)
Status	In progress

Introduction

The goal of this project is to improve the use of the wiki, both for pirates and non-pirates. The wiki is a workplace and our memory. To be transparent we need to make sure that information can be easily found and is presented in a way that is easy to understand. If we want people to use this wiki as such, we need to make sure that we keep the threshold for using the wiki as low as possible.

Board

This board is used to present the changes that can or need to be made and also to give an idea of the improvement we are making in general. You see that the board has a Proposals-section, a ToDo-section, a Doing-section and a Done-section. The Proposals section is to give proposals (of course :p ). You can write proposals to improve the wiki in the pad. We can't guarantee that everything on this pad will be executed, but it will be taken into account.
When making a proposal, please be clear about what exactly it is that you want, state a clear goal, possibly with examples.
Things that are decided that need to be done come in the #ToDo section. When someone starts on this project, they can move this to the #Doing section and then to the #Done section once the goal is reached.
Because the wiki changes (definitely during this project), it is possible that things from the #Done section return to the #ToDo or #Doing section.

ToDo

Wiki-manual

• Add the use of the different Forms to the manual.
• Update the pad-section. We now have pads that do use https, so the warning that pads might not show must be updated.
  • There are still pads on the wiki without https, so the warning should be kept. I would just change the sentence to say that some pads will show up as a blank and ugly rectangle. --HgO (talk) 20:25, 28 February 2017 (CET)
• Add a link to the Help:Conventions somewhere
• Split the manual into chapters
  • I think that the manual would be more readable if we split it into chapters. We would thus have smaller pages --HgO (talk) 20:25, 28 February 2017 (CET)

Survival guide

• The Dutch version of the guide needs some touch-ups, rephrasing of certain sentences and added translations.

New links for the top and sidebars

• See this section

Create a Help:Lexicon

• We have a link from the Main_Page_test to a lexicon. This still needs to be created. This can be a page or a section on another page (maybe Welcome/Guide#Petit Lexique?)
• We could use this extension as well: https://www.mediawiki.org/wiki/Extension:Semantic_Glossary

Crew form

• Add translations for some labels

Translate the wiki

• Make a tutorial on how to do it ?

Create a Help:Events

• Documentation on how to use the event system, see #Events

Doing

Main Page

• This is being created on Main Page test, there is a TODO list on the page.

Template:ProjectSidebar

• Rethink the sidebar in order to make it easier to use. There is a draft here.

Help:Conventions

• Updating the naming and usage conventions page
• TODO: Project's naming convention (cf. pad)

Events

• Implement a great event system.
• What needs to be done:
  • Create some documentation / how to, here for instance Help:Events
• At the moment, we can already:
  • Create different type of events using forms (Meeting, PirateBeer, External event, or no specific event)
  • Use multiple dates for external events (each separated by a coma)
  • Assign multiple workgroups (each separated by a coma)
  • List events
    • We can filter them by types:
      • For instance, we can choose to display all events but external ones, with {{Events|type=!External}}
      • or we can display pirate beers and meetings, with {{Events|type=PirateBeer, Meeting}}
    • We can filter them by workgroups:
      • For instance, we can choose to display all events but those from Crew BW, with {{Events|!Crew BW}}
      • or we can choose to display events from different workgroups, with {{Events|A workgroup, Another workgroup}}
    • We can filter them by date:
      • For instance, we can choose to display only future events and show the closest first, with {{Events|start=now|order=asc}}
  • Show events from given wiki pages
    • For instance, we can display the Pirate Lab of March 2017 together with the wiki workshop event, with {{ShowEvent|Pirate Lab/Meeting/25 03 2017, WikiSquad/Meeting/11 03 2017}}
      • By default, they are not sorted, because it would hide events that don't have a date. We can sort events by adding "sort = true" parameter (e.g. {{ShowEvent|Pirate Lab/Meeting/25 03 2017, WikiSquad/Meeting/11 03 2017|sort = true}})
  • Export event(s) as iCalendar, with {{Event ics|workgroup=Workgroup|type=Meeting}} or {{Event ics|Event page}} for a single event.
  • Display events on a map, with {{MapEvents|Workgroup|type=Meeting}}

Done

Meeting form

We created a standard form so that people can easily create an event page on the wiki.

Crew form

We created a standard form so that people can easily create a crew page on the wiki.