Skip to content

Commit

Permalink
Add capacity building documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
Deepthi-Chand committed Nov 1, 2021
1 parent daecced commit 5f78922
Show file tree
Hide file tree
Showing 3 changed files with 34 additions and 4 deletions.
9 changes: 8 additions & 1 deletion capacity-building/003-ghost.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,5 +6,12 @@ Live instance: https://ghost.noral.civicdatalab.in
## Why Ghost?

- Free and Open Source Software
- Highly custamizable
- Has rebust integration mechanisms
- Has native Search Engine Optimization
- Has native rest api
- Can be used as Headless CMS
- Well documented

## How to Use Ghost?
## How to Use Ghost?
Once setup, ghost is very easy to use. Most of the process is documented by team at ghost [here](https://ghost.org/resources/building/) ina quick read formats.
24 changes: 23 additions & 1 deletion capacity-building/004-discourse.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,28 @@ Live instance: https://discourse.noral.civicdatalab.in

## Why Discourse?

- Opensource
- Robust Community moderation mechanisms
- Strong community
- Context focussed UI for conversations
- Responsive web design
- Native mobile applications

## How to Use Discourse?
### Nomenclature
Here are some very basic terms that will be helpful to keep in mind as you use Discourse or read this guide:

## How to Use Discourse?
**Topic:** The collection of messages grouped together in a meaningful conversation, with a title, listed in a category, beginning with an Original Post, and including all replies in chronological order.
Elsewhere this might be called a ‘thread’ but Discourse uses ‘topic’ since thread is used for linked elements that can go off in many different directions (and be confused with programming terms).

**Post:** Each element of a topic is referred to as a post. Each post has its own author and can be moved to a different topic if necessary, or even become the start of a new topic.

**Original Post (or OP):** The first post in any topic. This is key since it determines the focus of the topic and is what the title and tags will link to.

**Category:** The primary means of organizing topics. Each topic is placed in exactly one category. Categories have permissions which can restrict which users can create, reply, and see its topics. You can also configure notification preferences per category or even mute them as explained below. Categories are a similar concept to a ‘forum’ on other sites.

**Tag:** A marker placed on a topic to describe it. While a topic can only have one category, it can have multiple tags. New tags can be created by some users. You can read more about the differences between tags and categories 74.

**User:** Discourse sites may be private or public for anyone to read, but you will always be required to register in order to create posts and record any actions such as bookmarking, liking, tagging, and flagging. Most site activity, therefore, is based around registered Users

Usage of the forum is well documented by the discource community [here](https://meta.discourse.org/t/discourse-new-user-guide/96331#browsing-the-forum)
5 changes: 3 additions & 2 deletions capacity-building/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,9 +13,10 @@ The requirements for this feature are:
2. Discourse

### Ghost
Ghost can be used as the one place to create/collate all the resources required using its pages and resources module. It can be configured as a CMS system to enable editing of content by concerned users.

GHost in conjunction with custom UI/UX can create a resource hub focussed on creating and sharing content to all relevant users.


### Discourse


Discourse is a powerful tool which can be used to enable conversations between the users which can be moderated and focussed. It can be used to share information/ learnings with other users. With inbuilt email newsletter feature, information can reach the target audience with click of few buttons.

0 comments on commit 5f78922

Please sign in to comment.