The online version of the ExpressionEngine User Guide has a new feature allowing users to contribute notes to each page.! It is our hope that users will utilize this ability to expound on details that they found useful.
This is an archived forum and the content is probably no longer relevant, but is provided here for posterity.
The active forums are here.
July 05, 2007 4:24pm
Subscribe [4]#1 / Jul 05, 2007 4:24pm
The online version of the ExpressionEngine User Guide has a new feature allowing users to contribute notes to each page.! It is our hope that users will utilize this ability to expound on details that they found useful.
#2 / Jul 05, 2007 5:44pm
Very nice addition, i’m sure this will get abused for the good of the community!
One gripe - the border around the community notes rss feed ;]
#3 / Jul 05, 2007 5:46pm
Very nice addition, i’m sure this will get abused for the good of the community!
One gripe - the border around the community notes rss feed ;]
::grumbles at different browser defaults:: (fixed)
#4 / Jul 05, 2007 6:14pm
Nice! - How about adding the feed to the “RSS Feeds” in the sidebar of the Blog & News section too? 😊
#5 / Jul 05, 2007 6:20pm
It’s not a blog, and our other feeds are not listed there, so we’ll probably keep the link where it is for the time being. Eventually I’ll put together a master feed page with all of our available feeds, though.
#6 / Jul 05, 2007 6:23pm
It’s not a blog.
Ahh true. Still the Master Feeds page would be nice. Thx!
#7 / Jul 17, 2007 1:46pm
That’s awesome. Love the feed!
#8 / Mar 14, 2008 10:59pm
Noffernuthin, but…
we can’t contribute to the user notes until we’ve posted 100 messages to the forum.
Aren’t newbies the *most* likely to be going through the manual, page by page, and discovering things that could be cleared up?
If it’s spam you’re worried about, maybe moderation is the key?
#9 / Mar 14, 2008 11:06pm
Noffernuthin, but…
we can’t contribute to the user notes until we’ve posted 100 messages to the forum.
Aren’t newbies the *most* likely to be going through the manual, page by page, and discovering things that could be cleared up?
If it’s spam you’re worried about, maybe moderation is the key?
No, new users and those who have not contributed to the forum community are the most likely to not yet have a “lightbulb” moment with the application, leading them to either post questions to the user guide, or misinformation based on incorrect assumptions. So far this has kept the quality of contribution high, and been a fun reward for users who first take the time to get involved in the community. If you ever have an issue with the documentation that you think needs clarification, don’t hesitate to post to the forums or email us directly. Your feedback is still important to us, and we do not reject thoughts and ideas just because you haven’t reached the threshold to post your own comments to the user guide.
#10 / Jul 21, 2008 3:38pm
Random question related to the architecture of the User Guide.
If the User Guide is created with static HTML rather than EE, how are you generating user contributions in the documentation? This stems from the conversation here, http://ellislab.com/forums/viewthread/82700/
#11 / Jul 21, 2008 6:35pm
The docs are run through a template so that ExpressionEngine is executed. A plugin on the template ensures that there is a weblog entry for each page of the docs, creating it automatically if needed for new pages. This is only for association for comment entries; the actual content is still served from the static files, not contained in an entry in any way. There’s some additional trickery for modifying relative paths to point to the proper location on the server, and sending the proper headers for certain file types (plain text files for example), but that’s the gist of it.