WikiSquad/Project/Improving the Wiki

From Pirate Party Belgium
< WikiSquad
Revision as of 20:54, 16 March 2017 by Ilja (talk | contribs) (Wiki-manual)
Jump to: navigation, search
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.

Proposals

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
    • this was already in the help section, I added it to the Extra resources
  • 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)
    • The wiki is changing, so I wouldn't want to do this to soon (and then see that we have to do it all over again), but I definitely feel that a restructuring is getting necessary :/ --Ilja (talk) 20:54, 16 March 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

Create a Help:Lexicon

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 events system, see #Events

Doing

Main 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.

Change log of February 2017