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?


#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