Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Adding a bit more details to the mindmaps manual #848

Closed
ghost opened this issue Apr 19, 2020 · 3 comments
Closed

Adding a bit more details to the mindmaps manual #848

ghost opened this issue Apr 19, 2020 · 3 comments

Comments

@ghost
Copy link

ghost commented Apr 19, 2020

There has been repeated confusion about the concept color on the Q & A sites. While everything is explained in the manual, I feel it might make sense to stress the distinction between child and node even more.

Version: 3.1.5

There is nothing wrong in the manual but the explanations on p. 721 are not too exhaustive. Instead of Here is an example of a tree built in this way: we could write

Let us now build a tree that way. Please note that we pass the concept color to the respective child and note to a node under it.

And in the code example one could add this information, too, since many users just look at the examples.

% preamble: \usetikzlibrary{mindmap}
\begin{tikzpicture}
\path[mindmap,concept color=black,text=white] node[concept] {Computer Science}
[clockwise from=0]
% note that `sibling angle' can only be defined in % `level 1 concept/.append style={}'
child[concept color=green!50!black] {
node[concept] {practical}
[clockwise from=90]
child { node[concept] {algorithms} }
child { node[concept] {data structures} }
child { node[concept] {pro\-gramming languages} } child { node[concept] {software engineer\-ing} }
}
child[concept color=blue] { % note that the concept color is passed to the child(!)
node[concept] {applied}
[clockwise from=-30]
child { node[concept] {databases} } child { node[concept] {WWW} }
}
child[concept color=red] { node[concept] {technical} } child[concept color=orange] { node[concept] {theoretical} };
\end{tikzpicture}
@ghost ghost added the manual label Apr 19, 2020
@hmenke
Copy link
Member

hmenke commented Apr 19, 2020

Ha! I'd estimate that 90% of users on Q&A sites don't even know that the manual exists. Improving the manual is always just exercises in futility, but sure it can be done.

@hmenke hmenke added this to the 3.1.6 milestone Apr 19, 2020
Mo-Gul added a commit to Mo-Gul/pgf that referenced this issue Apr 24, 2020
@hmenke
Copy link
Member

hmenke commented May 18, 2020

@tallmarmot Is the note that @Mo-Gul committed in e6e91c4 sufficient? If yes, please close this and add the closed-fixed label.

@ghost
Copy link
Author

ghost commented May 19, 2020

@hmenke Looks great except that I had a typo "and note to a" which should be "and not to a", i.e. the "note" should be a "not". Clearly my bad but the typo propagated.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Development

No branches or pull requests

1 participant