1,365
edits
No edit summary |
|||
| Line 4: | Line 4: | ||
== The Plan == | == The Plan == | ||
* In the summary/first paragraph for each sub-article, say that this is | * In the summary/first paragraph for each sub-article, say that this is panel [Foo] of the Options window reference, and link back to the parent Options window article. Example: "This article explains the [Foo] panel of the Options window in Firefox. See ((Options window)) for the other sections." | ||
* At the end of each sub-article, add a link back to the parent Options window article | * At the end of each sub-article, add a link back to the parent Options window article | ||
* In the parent Options window article, keep the summary/first paragraph, but replace the actual content with a list of links to the sub-articles | * In the parent Options window article, keep the summary/first paragraph, but replace the actual content with a list of links to the sub-articles | ||
* Name the sub-articles "Options window - [Foo] | * Name the sub-articles "Options window - [Foo] panel" | ||
I suggest the following roll-out plan: | I suggest the following roll-out plan: | ||
# Create the sub-articles in en-US while keeping the parent/original article untouched to see our suggestions in action and make sure we like the content and layout. | # Create the sub-articles in en-US while keeping the parent/original article untouched to see our suggestions in action and make sure we like the content and layout. | ||
# Talk to localizers about the concrete plan and show the en-US articles and explain what we need help with (writing the generic summary for each | # Talk to localizers about the concrete plan and show the en-US articles and explain what we need help with (writing the generic summary for each panel, the link back to the Options window). Obviously we need as much help we can get, but for the locales that don't have time or interest, we will have to do it ourselves. | ||
# Lock the parent Options window articles for editing. We don't want people to remove content from here until we've updated the in-product links. Otherwise we'll break current product help. | # Lock the parent Options window articles for editing. We don't want people to remove content from here until we've updated the in-product links. Otherwise we'll break current product help. | ||
# Finish the sub-article creation for each locale and help the locales that don't/won't do it. | # Finish the sub-article creation for each locale and help the locales that don't/won't do it. | ||
# Push new .htaccess rules to production so the in-product links point to the new sub-articles where appropriate. | # Push new .htaccess rules to production so the in-product links point to the new sub-articles where appropriate. | ||
# Finally, change the parent Options window articles as agreed on, so it's just this generic intro + links to sub-articles. | # Finally, change the parent Options window articles as agreed on, so it's just this generic intro + links to sub-articles. | ||
edits