[Tagging] List of obviously needed improvements to OSM Wiki
steveaOSM at softworkers.com
Sun Jan 17 23:52:53 UTC 2021
I also wish to thank Mateusz profusely for his excellent first-draft organization of some important wiki clean-up. While posting this to the tagging list is important, I suggest making a "meta-wiki" page of this: let's use the wiki to improve the wiki! Perhaps Mateusz' suggestions could live on in a jumping-off link in the vicinity of https://wiki.osm.org/wiki/WikiProject_Cleanup.
I've written a fair bit of wiki here during my time at OSM, it isn't that hard. There are at least two editors / methods to write wiki: a more "raw" version ("Edit Source" link-button for "Source Editing") and a more user-friendly version ("Edit" link-button) which does a more what-you-see-is-what-you-get job of it ("Visual Editing"). The former is good for more experienced editors who are familiar with MediaWiki's language, especially if you are including more-advanced features like templates or tables, the latter is good for novice users who want to jump right into creating new wiki or editing existing wiki that have a simple, basic structure, which is often plenty to convey what a good wiki conveys: "here is how we do 'this' in OSM."
Wiki are vital to how OSM works: I'm sure there are exceptions, but can you imagine mapping in OSM without reading at least ONE or TWO wiki? Of course not! We ALL rely on well-written wiki that explain "how."
I have found that what works well is an attitude of straightforward, friendly, if-you-read-this-you-can-do-it-too. Do not believe that you must write a perfect wiki the day you create it from scratch, if we think like that, we'll never write ANY wiki! You and other wiki Contributors can fuss over making any wiki totally complete and comprehensive tomorrow, next week, next month or over the course of the next year: how wiki tend to work is that they "grow into better" over time. And that's OK.
Taking the time to contribute mapping data is great: mapping with your favorite editor is at the root of OSM. But wiki are crucial and YOU really CAN help! Take a look at Mateusz' list and see if there isn't something that stirs your passions and offers a "hole" in OSM's knowledge and documentation that presents to you an opportunity to fill with your knowledge and time writing a bit to share with others. It isn't hard, it can be fun and it is rewarding to know that you are making OSM a stronger project. Thank you!
> On Jan 17, 2021, at 4:13 AM, Mateusz Konieczny via Tagging <tagging at openstreetmap.org> wrote:
(quite a bit, but I feel the most important part of it is):
> OSM Wiki includes plenty of useful documentation, but more is needed.
> Help would be highly welcomed - there is need to both improve existing
> wiki pages and to document tags that are not documented right now.
More information about the Tagging