Using Discourse

From Open Source Ecology
Jump to: navigation, search

Starting Organizing Categories

  • To start a category - in Admin, click on Categories - and upper right hamburger is Add Category. [1]
  • Staring subcategories - upon creation, you can select it to nest under.

Wiki Integration

  • Discourse should work closely with wiki.
  • Discourse threads for different machines are embedded on wiki.

Search

  • Search feature appears to be robust. You can search any topics by keywords, which integrates well with OSE infrastructure such as wiki.
  • Taxonomy for versioning should be followed. Thus - machine name - 3D Printer v20.04 should be equally searchable on wiki and on forums.

Images

  • Image upload should be turned off for memory management purposes.
  • Images are uploaded to the wiki.

Badges

  • Create custom badges for people familiar with design. Create Design Guides and Test for each design - so that we qualify able designers who use the OSE design principles. [2]
  • Discourse can serve as a go-to place for certifying skills, and thus becomes a priceless source of transparent development talent. If we teach people high quality skills, then the OSE Community (Forum) becomes a critical part of OSE development infrastructure. By making skill sets transparent, we create star talent, and external audiences, ideally, start to recognize the OSE Community as a formidable source of development talent. This will help tremendously during Incentive Challenges, and would allow us to solve COVID-scale problems readily by leveraging our community.
  • To grant a badge, go to Admin->Users->Badges
  • Note that badges icons should have a transparent background to look good.
  • Phasing it in - we can set up badges and allocate them gradually.
  • Badges can show up only when clicking on the user - so we don't overfill the discussion pages with badges, but we can find out more info about a user by clicking on that user.

Embedding

I followed what they said to produce the HTML:

<html>

<div id='discourse-comments'></div>

<script type="text/javascript">
  DiscourseEmbed = { discourseUrl: 'https://discourse.opensourceecology.org/',
                     discourseEmbedUrl: 'https://wiki.opensourceecology.org/wiki/Test'};

  (function() {
    var d = document.createElement('script'); d.type = 'text/javascript'; d.async = true;
    d.src = DiscourseEmbed.discourseUrl + 'javascripts/embed.js';
    (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(d);
  })();
</script>

</html>


Nothing appears. See how I set it up on Discrouse:

Embedsetup.png

Can you help me do a successful embed?