[TYPO3-doc] left nav menu is always collapsed?

Xavier Perseguers xavier at typo3.org
Mon Jul 22 12:18:49 CEST 2013


Hi,

> OK. All three docs (and possibly others in the future) should be
> included in the Flow git repository so that all documentation changes
> can be included in the same commit as the code that adds a particular
> feature.

If this is critical for you then you need to stay with one single
document, but then it's not 3 documents, it's a single document which
you logically split into 3 main chapters representing "subdocuments" in
your mind, that's up to you, for docs.typo3.org it's still one single
document.

> To create these separate docs within the same package, would we have to
> duplicate _make and Settings.yaml in each of the Documentation/*
> subfolders (where each subfolder of Documentation/ represents a
> different document)?

No, because we won't add logic for special cases such as "Documentation
is not a documentation folder but a 'master-documentation' folder".

If you think of more than 3 documents in future, then you certainly will
have to relax a bit from "1 single commit for multiple documents".
Because you would have to take books on Fluid, on Flow, on Flow v2, ...
into account.

I'd say that it can be solved these ways:

1) single commit = single document (does not scale to many more documents)

2) multiple commits to multiple repositories
	a) either separate
	b) or "linked/glued" with a tag (possible in Gerrit)
	c) or "linked/glued" in bug tracker with a meta umbrella ticket (more
work but clear for everyone)

Cheers

-- 
Xavier Perseguers
Release Manager TYPO3 4.6

TYPO3 .... inspiring people to share!
Get involved: http://typo3.org



More information about the TYPO3-project-documentation mailing list