CompleteNoobs Community Guidelines for Hive

Welcome to the CompleteNoobs community on Hive! This is a space for sharing beginner-friendly tutorials, guides, and documentation for Linux and open-source software. CompleteNoobs is in a draft conceptual phase, and we’re testing whether Hive can support a platform for rewarding contributors who create high-quality, reproducible tech content.

Below are the guidelines for posting in the CompleteNoobs community on Hive.

About CompleteNoobs

• Purpose: CompleteNoobs aims to host tutorials, guides, and walk-throughs for Linux beginners, using a wiki-based platform (completenoobs.com). We’re exploring Hive as a way to tip, donate, or reward contributors.
• Status: This project is in early development. We’re testing workflows and hopefully engagement.
• Wiki Syntax: CompleteNoobs uses wiki syntax for posts, but Hive does not currently have a front-end to render wiki syntax natively. Current solution use TAGS: syntax_wiki or syntax_mark, there is a script that lets us pull down content from hive as is, if in markdown can convert to wiki syntax.

How to Post in the CompleteNoobs Community

To contribute to the CompleteNoobs community on Hive, follow these guidelines (note: this is still in the poke it with a stick stage of dev, and may change as we learn more, the further we go the more we learn):

1. Use Wiki Syntax:

   • Note: Markdown does work and can be coverted to wiki syntax using a script, but wiki syntax is better.
   • Format your post using wiki syntax (e.g., ==Heading==, * Bullet, bold). See basic wiki syntax: https://www.completenoobs.com/noobs/Wiki_Basic_Syntax
   • Hive renders most Markdown and some HTML tags, but MediaWiki-specific syntax (e.g., '''bold''') may not work.
   • Example:

     == Installing UFW on Ubuntu ==
     * Open a terminal
     * Run: sudo apt install ufw
     

2. Add the 'syntax_wiki' or 'syntax_mark' Tag:

   • Include the tag syntax_wiki when posting to help us identify CompleteNoobs contributions and the syntax.

3. Focus on Reproducible Instructions:

   • Write clear, step-by-step instructions that others can follow.
   • Test your instructions to ensure they work as described.
   • Example: Instead of “Install the package,” specify “Run sudo apt install package-name in the terminal.”

4. Specify OS and Architecture:

   • State the operating system (e.g., Ubuntu 22.04, Debian 12) and architecture (e.g., x86_64, ARM) used in your tutorial.
   • Example: “This guide was tested on Ubuntu 24.04 LTS (x86_64).”

5. Include a Compatible License:

   • Add a license header at the top of your post from the approved list at https://www.completenoobs.com/noobs/LICENCE_HEADERS.
   • Example:

     {{:LICENCE_HEADER_CC_BY-SA}}
     

   • This ensures your content can be shared and reused legally.

Getting Featured on completenoobs.com

Selected posts from the CompleteNoobs community may be copied to https://www.completenoobs.com, with a link back to the original Hive post. To be eligible, your post must:

• Use wiki syntax with the wiki_syntax tag.
• Provide reproducible, step-by-step instructions.
• Specify the OS version and architecture.
• Include a compatible license header.
• Be beginner-friendly.

Posts are manually reviewed, and not all submissions will be featured. If selected, your post will be credited with a link to your Hive post.

Download wiki locally so you can edit and check syntax of your own posts privately on your own wiki

• Works using Docker: https://www.completenoobs.com/noobs/Local_CompleteNoobs_Wiki