[pmwiki-users] Translation downloads updated

[Petko Yotov]

On Friday 13 February 2009 18:57:51 Oliver Betz wrote:
> Petko Yotov wrote:
>
> [...]
>
> >> >[1] I can use some help. If people from the community have the time and
> >> > are willing to help out, we could review all PmWiki/* pages and fix
> >> > them with an edit summary like "Ok for a release". This will be much
> >> > faster. (Other ideas are welcome too.)
> >>
> >> IMO a page text variable containing the documentation status as in the
> >> PmWikiDe pages is a good thing because they enable the use of
> >> pagelists.
> >
> >An inexperienced author could break a page without removing the text
> > variable. The page will need fixing, but the pagelist will not show it.
>
> (and I replied that the edit summary is less robust)
>
> Did you already think about this?

Yes, but still I feel an edit summary is better, and more robust/clear. 

Let's not argue, we can do both, a pagelist can display all these 
informations:

* the date (+time UTC or CET for the european languages)
* the last author, if it is a known, trusted user, it should be ok
  (we don't know all trusted users on all language versions, but we can
   assume good faith, especially if there are edit summaries, and the
   page history seems ok.)
* the last edit summary
* all page text variables that you require
* the list may be ordered by date, most recent on top


> Another advantage of a PTV is that we could mark pages as "not
> necessary in the distribution". Then we didn't need to revisit these
> pages too often.

Agreed. And, if we are well organized, maintaining good versions on all pages 
should be easy and fast. (Once we have reviewed all pages.)

> I could imagine to mark pages "ready for distribtion" (with date of
> the check), "needs work before distribution", "not needed in
> distribution". Abbreviations would be useful for a listing.

Today I'll go through all pages in the English documentation, and I'll 
update/sync the pages for the release. (Even if people are pushing for 
simplification, and I agree with them, we'll deal with it when necessary.) 

In the next days/weeks I'll try to work on the French docs, to prepare a 
simplified subset of them. PmWiki is a complex software with stunning 
capabilities, but when a newbie sees the docs, they may look scary and far 
too complicated. But the truth is that 99% of the authors, 99% of the time, 
will need only the most basic markup for their pages.

Thanks,
Petko