Hello, WikiCareTakers and Web… eh… people!
I am part of the Fellowship Group in Berlin and we want to do a hack session, where we want to improve the FSFE website and the wiki in general and our personal wiki (and some edu-related) pages in particular.
@all Are there any pages, that need improvement, where we should take look at? Is there anything that we should keep in mind while working on the website? Are there things that we should especially avoid? Is there anything else, that you'd like to mention?
@web Should we push our changes to the test branch first?
Thanks for your help!
Live long and free software!
-- Erik (egnun)
Hi Erik,
Am Mittwoch, 18. April 2018, 12:13:18 CEST schrieb Erik Grun:
I am part of the Fellowship Group in Berlin and we want to do a hack session, where we want to improve the FSFE website and the wiki in general and our personal wiki (and some edu-related) pages in particular.
Thank you for doing this!
@all Are there any pages, that need improvement, where we should take look at?
There are quite a few pages that need improvement, but we don't have a list currently. Generally speaking, it is probably best to concentrate on those pages that you have some background knowledge at first. Chances are that you run out of time before you run out of work :-p
Also, if you have people with a good command of the English language: proof- reading is underrated but is quite an important task.
Is there anything that we should keep in mind while working on the website?
A starting point for the wiki would be here: https://wiki.fsfe.org/TechDocs/Wiki
or maybe also the slides from my WikiCaretakers talk at the FSFE Summit: https://conf.qtcon.org/en/qtcon/public/events/760.html
The TechDocs/Wiki page covers the wiki as it is now. The talk/slides give an overview of the things that changed compared to the "old" (pre WikiCaretakers) wiki.
Are there things that we should especially avoid?
Actually, thinking of this question, I do have some specific part of the wiki that could be improved: Categories.
Compared to the "old way", the wiki nowadays is much more hierarchical in nature. This also means that while previously categories were used to group things together this is now achieved by putting related content within the same namespace.
When we started the "new" wiki, I tried to encourage this by having a page for each category that describes what pages should be in it. You can see this e.g. here: https://wiki.fsfe.org/Category/CountryTeam https://wiki.fsfe.org/Category/Portal
However, since then the situation has somewhat deteriorated, and some categories from the old wiki have been reintroduced blindly and/or lack a description.
Maybe you can improve this situation a little while working on the other pages…
Is there anything else, that you'd like to mention?
If you see a problem but can't fix it right away, mark it for the next wiki sprint by adding it in the category [[Category/ImproveThisPage]]
Have fun! Johannes
Hi again,
Of course I totally forgot to mention this page, which shows broken links in the wiki:
https://wiki.fsfe.org/WantedPages
Cheers, Johannes
Am Donnerstag, 19. April 2018, 22:46:04 CEST schrieb Johannes Zarl-Zierl:
Hi Erik,
Am Mittwoch, 18. April 2018, 12:13:18 CEST schrieb Erik Grun:
I am part of the Fellowship Group in Berlin and we want to do a hack session, where we want to improve the FSFE website and the wiki in general and our personal wiki (and some edu-related) pages in particular.
Thank you for doing this!
@all Are there any pages, that need improvement, where we should take look at?
There are quite a few pages that need improvement, but we don't have a list currently. Generally speaking, it is probably best to concentrate on those pages that you have some background knowledge at first. Chances are that you run out of time before you run out of work :-p
Also, if you have people with a good command of the English language: proof- reading is underrated but is quite an important task.
Is there anything that we should keep in mind while working on the website?
A starting point for the wiki would be here: https://wiki.fsfe.org/TechDocs/Wiki
or maybe also the slides from my WikiCaretakers talk at the FSFE Summit: https://conf.qtcon.org/en/qtcon/public/events/760.html
The TechDocs/Wiki page covers the wiki as it is now. The talk/slides give an overview of the things that changed compared to the "old" (pre WikiCaretakers) wiki.
Are there things that we should especially avoid?
Actually, thinking of this question, I do have some specific part of the wiki that could be improved: Categories.
Compared to the "old way", the wiki nowadays is much more hierarchical in nature. This also means that while previously categories were used to group things together this is now achieved by putting related content within the same namespace.
When we started the "new" wiki, I tried to encourage this by having a page for each category that describes what pages should be in it. You can see this e.g. here: https://wiki.fsfe.org/Category/CountryTeam https://wiki.fsfe.org/Category/Portal
However, since then the situation has somewhat deteriorated, and some categories from the old wiki have been reintroduced blindly and/or lack a description.
Maybe you can improve this situation a little while working on the other pages…
Is there anything else, that you'd like to mention?
If you see a problem but can't fix it right away, mark it for the next wiki sprint by adding it in the category [[Category/ImproveThisPage]]
Have fun! Johannes
Hello, Johannes,
On 19.04.2018 22:46, Johannes Zarl-Zierl wrote:
Am Mittwoch, 18. April 2018, 12:13:18 CEST schrieb Erik Grun:
I am part of the Fellowship Group in Berlin and we want to do a hack session, where we want to improve the FSFE website and the wiki in general and our personal wiki (and some edu-related) pages in particular.
Thank you for doing this!
I'll forward that to the others. :-)
There are quite a few pages that need improvement, but we don't have a list currently. Generally speaking, it is probably best to concentrate on those pages that you have some background knowledge at first. Chances are that you run out of time before you run out of work :-p
That's true. I was just looking for pages on the website and the wiki and already found more than enough for our session today. ;-)
The TechDocs/Wiki page covers the wiki as it is now. The talk/slides give an overview of the things that changed compared to the "old" (pre WikiCaretakers) wiki.
Actually, thinking of this question, I do have some specific part of the wiki that could be improved: Categories.
However, since then the situation has somewhat deteriorated, and some categories from the old wiki have been reintroduced blindly and/or lack a description.
Maybe you can improve this situation a little while working on the other pages…
We'll see what we can do about that. :-)
Thank you for your help! :-)
Live long and free software!
-- Erik (egnun)
Hi Erik,
# Erik Grun [2018-04-18 12:13 +0200]:
I am part of the Fellowship Group in Berlin and we want to do a hack session, where we want to improve the FSFE website and the wiki in general and our personal wiki (and some edu-related) pages in particular.
Great, thanks for your interest in helping and sorry for the late reply.
@all Are there any pages, that need improvement, where we should take look at?
The Git issue tracker for the main website should contain quite a few things we could use help with:
https://git.fsfe.org/FSFE/fsfe-website/issues
There is also one for the Wiki but less populated:
https://git.fsfe.org/fsfe-wiki/wiki-setup/issues
If you have questions on individual points, please ask in the respective issue. This way, all contributors can engage.
Is there anything that we should keep in mind while working on the website? Are there things that we should especially avoid? Is there anything else, that you'd like to mention?
Erm, not really. But you should read the various docs first if you never worked with the website before:
https://wiki.fsfe.org/Teams/Web
@web Should we push our changes to the test branch first?
Only if you make large changes. Otherwise, creating a Pull Request is sufficient. Ideally you tested your changes locally first. A guide on how to do that can be found linked in the wiki.
Best, Max
Am Mittwoch, 2. Mai 2018, 10:06:26 CEST schrieb Max Mehl:
There is also one for the Wiki but less populated:
https://git.fsfe.org/fsfe-wiki/wiki-setup/issues
If you have questions on individual points, please ask in the respective issue. This way, all contributors can engage.
That one is primarily for issues with the wiki software and wiki installation (Not to stop you from hacking on these). If you are interested on wiki content, just go with the stuff mentioned in my previous two mails...
Cheers, Johannes