Cleaning up our wiki

Shaun McCance <[email protected]> Tue, 20 Oct 2020 15:34:25 -0400
Newsgroups gmane.comp.gnome.documentation
Message-ID <[email protected]>
--=-xlRy7OY8PagruhU8/c33
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: 7bit

Today during the standup, I started an audit of the DocumentionProject
wiki space on wiki.gnome.org. There's a bunch of old stuff in there,
and it's confusing to people trying to join.

I immediately had the issue of where to do the audit. If I put it in
the wiki, then I'd be adding to the cruft I'm trying to clean. I ended
up using a Google Docs spreadsheet. Sorry. I've attached a tsv export
of the data I collected.

A lot of the pages are planning pages for things we maybe worked on at
some time. Either we finished these things, or we abandoned them, or
maybe sometimes they're ongoing. But maintaining them as wiki pages is
just not sustainable.

I propose we follow the path of the design team and some other teams in
GNOME by creating a group for our team on GitLab. We could then have a
project under this group called "Initiatives" or "Projects". We'd do
these sort of project plans as issues, which you can totally edit as
sort of planning docs. And when we're done, we close them.

For example, here's a similar setup for the design team:

https://gitlab.gnome.org/Teams/Design/initiatives/-/issues

Yay or nay?

--
Shaun


--=-xlRy7OY8PagruhU8/c33
Content-Disposition: attachment; filename="gnome-docs-wiki-2020-10-20.tsv"
Content-Type: text/tab-separated-values; name="gnome-docs-wiki-2020-10-20.tsv";
	charset="us-ascii"
Content-Transfer-Encoding: 7bit

Page	Path	Category?	Footer?	Comments
DocumentationProject		yes	yes	
DocumentationProject/Community	/	no	yes	
DocumentationProject/Contact	/	yes	yes (at the top)	
DocumentationProject/Contributing	/	yes	yes	
DocumentationProject/Contributing/SubmittingPatches				
DocumentationProject/DeveloperGuides		yes	yes	
DocumentationProject/Documents		yes	yes	
DocumentationProject/FirstPatch		yes	yes	
DocumentationProject/Goals216		yes	yes	
DocumentationProject/GtkDoc		yes	yes	
DocumentationProject/GtkDocFuture		yes	yes	
DocumentationProject/Guide	/	no	no	
DocumentationProject/Guide/Convert	/Guide	no	no	
DocumentationProject/Guide/DesktopHelp	/Guide	yes	yes	
DocumentationProject/Guide/LanguageStyle	/Guide	no	no	
DocumentationProject/Guide/Licensing	/Guide	no	yes	
DocumentationProject/Guide/Makefile	/Guide	no	no	
DocumentationProject/Guide/Mallard style hints	/Guide	no	no	
DocumentationProject/Guide/Pre-commit	/Guide	no	no	
DocumentationProject/Guide/Relicensing	/Guide	no	no	
DocumentationProject/Guide/Screenshots	/Guide	no	no	
DocumentationProject/Guide/StatusTracking	/Guide	no	no	
DocumentationProject/Guide/Translations	/Guide	no	yes	
DocumentationProject/Guide/Website	/Guide	no	yes	
DocumentationProject/Guide/XInclude	/Guide	no	no	
DocumentationProject/Hackfests	/Community	no	yes	
DocumentationProject/IdealDeveloperDocumentation		yes	yes	
DocumentationProject/Join		yes	yes	
DocumentationProject/Meeting20080203	none	yes	no	
DocumentationProject/Planning	/	no	yes	
DocumentationProject/Planning/BansheePlanning	/Planning	no	yes	
DocumentationProject/Planning/RhythmboxPlanning	/Planning	no	yes	
DocumentationProject/Surveys	/Planning	no	yes	
DocumentationProject/Tasks	/	yes	yes	
DocumentationProject/Tasks/ApplicationHelp	/Tasks	yes	yes	
DocumentationProject/Tasks/DesktopHelp	/Tasks	yes	yes	
DocumentationProject/Tasks/DeveloperDocs	/Tasks	no	no	
DocumentationProject/Tasks/DeveloperDocs/BeginnerTutorials	???	yes	yes	
DocumentationProject/Tasks/ReleaseSchedule	/Planning	no	no	
DocumentationProject/Tasks/SysAdminGuide	/Tasks	no	no	
DocumentationProject/Team		yes	yes	
DocumentationProject/TipsAndTricks		yes	yes	
DocumentationProject/TopicTypes	/Planning	no	yes	
DocumentationProject/YelpLinks		yes	yes	
DocumentationProjectPolicies		yes	yes	
Projects/GnomeDocUtils		yes	yes	
Apps/Yelp/ConsistentDocs		yes	yes	
--=-xlRy7OY8PagruhU8/c33
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

_______________________________________________
gnome-doc-list mailing list
[email protected]
https://mail.gnome.org/mailman/listinfo/gnome-doc-list

--=-xlRy7OY8PagruhU8/c33--