node-red / node-red.github.io

Node-RED Site
http://nodered.org
Other
99 stars 151 forks source link

flow-dev-guide: choose a name for the guide #93

Open knolleary opened 5 years ago

knolleary commented 5 years ago

I'm not sure Practice is quite the right title for this new section. I'd suggest Developing Flows would be more consistent with the other sections.

No need to change anything right away - as discussed, once we have more content in the guide I think it will be easier to identify the right way to integrate it with the existing docs. What you have here is a good start begin collaboration on it.

/cc @LEEHYUKJOO

LEEHYUKJOO commented 5 years ago

Actually, Developing Flows is nice for consistent with other sections.
However, I guess that readers can misunderstand that just a way to create flows with "Node-RED" (i.e., how to use Node-RED) is written. The purpose of this guideline is creating flows with readibility, reusability and so on.
 So, I'd like to consider title more.



How about bellow alternatives.


However, above two are too long to be on 1 line. Note that, the height of square is dependent on the number of lines.

@knolleary

knolleary commented 5 years ago

I don't think it would be a bad thing to have a single Developer Flows guide that covers the basics and covers best practices. Otherwise we'd have related content split across different parts of the documentation and a user would need to understand that separation. Not suggestion you need to produce that basic content as well - we can contribute those parts - but from an overall structure, maybe they should live together.

LEEHYUKJOO commented 5 years ago

I forgot that the contents of the guideline could be added continuously by other users. I realized that Developing Flows is the best title of this guideline.