Improve the README.md file and other documentation files for marketing and testers documentation, to survive the demise of the wiki
Many years ago, there was an initial attempt at improving the wiki page's documentation in #194 (closed).
Fast forward many years, in 2023 I rewrote / improved / updated most of the pages in https://wiki.gnome.org/Apps/Calendar/
However the GNOME Foundation wants to kill the wiki: https://discourse.gnome.org/t/wiki-gnome-org-retirement-feedback-wanted/17314
...so we'll need to migrate stuff to gitlab (unless we make a dedicated website for GNOME Calendar). Note that while markdown is the primary format commonly used in GitLab, we might not be limited only to markdown, I am told we can use HTML too... but if you do, let's please not make a nasty unmaintainable messy blob (if we wanted that, we could use a CMS).
Recently there was a spontaneous attempt by a newcomer to tweak the readme file's documentation in !363, but none of us had a particular opinion of what it should look like for starters...
Personally, I suspect maybe migrating some of the contents from the various pages from the wiki to it would already be a decent approach, since we will have to salvage those contents "somehow" when GNOME decides to kill the wiki infrastructure soon...
I currently don't have time to be doing copywriting, so anyone who feels inspired to achieve something equal or better than what was on the wiki is welcome to, but you'll probably have to figure out how to best merge the wiki and readme's documentation in a way that makes sense; it's hard for me to be explaining my writing style, because it would take me longer to explain than to write :)
Up for grabs / help wanted.
In addition to the text, visuals need to be updated too:
- Screenshots on the wiki page are outdated
- Screenshots on https://apps.gnome.org/Calendar/ are not "nicely representative of real-world usage examples", either
It might also be nice to explain to testers/early-adopter users how to build/test branches and merge requests to help with GNOME Calendar's development. There are some tips about that in the comments there: #1106 (comment 1855644)