Documentation in Discourse now synchronised to web


#1

As a follow up to my post entitled Documentation migrated to Discourse another phase is now complete. Updates to initial topic posts in the Docs category are now published, pretty much instantaneously, on the documentation web site: docs.jujucharms.com. :man_cartwheeling: The home page and the commands page are treated separately.

At the top of docs.jujucharms.com there are links to both the documentation web site (redundant?) and Discourse:

image

At the bottom of each documentation web page there is a blurb pointing readers to the corresponding Discourse topic if they wish to improve upon it:

image


#2

Just a thought: is “Discourse” the best name for that link? I’m not sure if many people know what Discourse is. Maybe just “Forum” or “Community” or something?


New docs page in jaas.ai and redirects from docs.jujucharms.com
#3

Agree. I also think that the subdomain should be changed too to reflect that purpose rather than be the name of the tool.


#4

Yes, I agree. That’s what the Snapcraft site does as well.


#5

You mean replace jujucharms.com?


#6

I suspect he means using community.jujucharms.com instead of discourse.jujucharms.com, which I support too.


#7

Ah ok. Yes, I agree as well. Possibly use the term “forum” instead of “discourse” everywhere.


#8

Yes that is what I meant. Thanks @merlijn-sebrechts


#9

Unfortunately just now we have been told that we need to keep the moniker discourse. While I’m not overly fond of it, it is what we have just now.


#10

Hello, the web-team is moving subdomains to the main domains and navigation across products and websites. E.g. the recent move (see here) from docs.jujucharms.com to jaas.ai/docs. Discourse.jujucharms.com will move as well.
About ‘Discourse’ as a name, that is also something that will need to work across websites and products to be consistent everywhere.