[TYPO3-core] The documentation patch has landed :-)
fsu-lists at cobweb.ch
Mon Jul 15 22:53:35 CEST 2013
I've just sent to Gerrit the patch corresponding to the migration of all
existing system extension manuals to reStructured Text!
I'm not sure how we want to proceed with the review, I don't think
anyone will really check every manual. Here is some information though:
1) all manuals render cleanly (i.e. without a single warning) on our
current rendering infrastructure.
2) the result can be viewed online (currently rendered from my fork ):
3) the manuals are all clean in terms of meta data and configuration for
4) however the manuals are not up to date in terms of content. I did
some small updates here and there, but updating everything is too much
work. This can be done incrementally once the migration is merged. In
particular we will need to update most screenshots before release. As I
said during the recent contributor's meeting, this makes it particularly
important to freeze UI changes at feature freeze too.
5) this patch brings back the indexed_search documentation inside the
extension. This had been the lost child of the official documentation
for years, but really belongs inside the extension. I guess it was
removed at the time because of its size. It weighs in at about 1.1 MB,
but I don't think that this is really critical as a download of the
6.1.1 source is a total of 54 MB. That being said, it could be trimmed
down by using less images (it is extremely "verbose").
6) there is a mysterious diff file stored inside the dbal doc folder,
which is also removed by this patch. I don't if it is of any importance.
If yes, we can find it a new home. See:
Don't hesitate to ask if you have questions. I'll wait for someone to
give me the green light before merging anyway.
Work: Cobweb Development Sarl - http://www.cobweb.ch
TYPO3: Help the project! - http://typo3.org/contribute/
Appreciate my work? Support me -
More information about the TYPO3-team-core