Divergence between wiki and source-tree docs

[Alexander Belchenko]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Aaron Bentley пишет:
> I think we should fix the divergence between wiki and source-tree docs.
>  I think it's a good idea to retain the wiki version as the primary
> version, because it is easier to update.

Probably you're right because on docs can work many people.
Not only core developers.

> Here's what I suggest:
> 1. switch the wiki versions of the documents to ReST
Basically only line with declaration
#format rst
is needed for usual ReST document
> 2. automate the process of copying the latest versions of the wiki
>    documents into the source tree
E.g., with simple python script that will pull RawSource from the wiki and
remove first line with declaration (#format rst) and put new
documents to bzr.dev/doc
> 3. make updating the source-tree documents part of the release process

I think this steps are easily doable and worth to implement.

- --
Alexander

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.5 (MingW32)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFF5wGozYr338mxwCURAu9OAJ9vFsNvmZDIHm2kRoPHu6wb7D0zPACdEZ1f
BRypEhdvRXTloU6qijwrd9U=
=9LHV
-----END PGP SIGNATURE-----