Difference between revisions of "Google Season of Docs 2022/Organize and Update Apertium User Documentation"

From Apertium
Jump to navigation Jump to search
(Created page with " == About Apertium == == About the project == === The problem === === The scope === === Measuring success === == Timeline == == Budget ==")
 
Line 5: Line 5:
   
 
=== The problem ===
 
=== The problem ===
  +
[https://wiki.apertium.org Apertium's wiki] and other documentation are out of date, poorly organized, not visible enough, and just plain not user-friendly.
  +
  +
This ranges from documentation of individual tools not reflecting their current state, to our best how-to guides reflecting how things were done a decade ago.
  +
  +
The result is new users and contributors wasting time reading out-of-date materials, and even long-time contributors having no way to be aware of changes to the tools they use.
   
 
=== The scope ===
 
=== The scope ===

Revision as of 16:23, 10 March 2022

About Apertium

About the project

The problem

Apertium's wiki and other documentation are out of date, poorly organized, not visible enough, and just plain not user-friendly.

This ranges from documentation of individual tools not reflecting their current state, to our best how-to guides reflecting how things were done a decade ago.

The result is new users and contributors wasting time reading out-of-date materials, and even long-time contributors having no way to be aware of changes to the tools they use.

The scope

Measuring success

Timeline

Budget