= Pls help us write this piece
Firstly, a very merry Christmas and Happy Holidays to you all!
For the final stretch of 2021, I’m moving my focus onto the NEAR Wiki. This consists of a focus on organization and content.
This will be my main focus until we break for the holidays. In this time I hope to achieve some semblance of a fleshed-out Wiki with an improved organisational structure.
To expedite the (near)completion of content in the Wiki, the Docusaurus migration has been put on hold. One of the leading reasons we were looking to transition to Docusaurus was due to the bugs which the Gitbook update presented (which resulted in lost articles), these now seem to be resolved.
The main inspiration for the future organisation of the NEAR Wiki is:
Feedback has been echoed within the NEAR Community and within NF itself regarding the simplicity, ease of access, and simple navigation the Polkadot Wiki has.
This is what we’re aiming for (and then some, of course).
The aims of the broader Wiki Development Plan, and the main focus of the Content Plan, are:
- Flesh out the Wiki content to ‘near completion’
- Create an easy to navigate and simple to access repo of all things NEAR
- Produce a ‘go-to’ website for the most common NEAR questions
Below I’ve outlined a content plan and organisational structure. If you have any feedback on this, please share it as soon as you can. We’re building this together
We’ll be leveraging the incredible talent of the NEAR Community and rallying the internal NF team to contribute to the relevant parts of the NEAR Wiki. More details on that in the NEAR Portal Guild Telegram - come join us!
h/t to the Legal Guild for getting a jump start on this and beginning to flesh out the Legal section of the Wiki already.
We’ll be using the NEAR Portal Guild to facilitate Community contributions to the Wiki. In the Telegram, we’ll work to develop a framework which will cover:
- Content creation
- Quality assurance & accuracy
- Wiki publication
Members of the NEAR Foundation should be responsible for the creation and publication of content relevant to their department (any objections?).
Based off of Illia’s feedback below, we’ll be organising the NEAR Wiki into four sections:
Below are the articles which I believe should be included in each category, alongside a proposed structure:
The below is simply a suggestion. I’d like to strongly encourage anyone and everyone to share their feedback so we can improve the NEAR Wiki for everyone
The goal of the structure is to send the reader through a journey. If you’re new to NEAR, you’ll be directed to wallet creation, website, news etc. If you’re an existing community member, you’ll be shown information on Guilds, education, and the like.
Landing Page: Introductory overview to NEAR including a link to the website
This article should serve as the ‘go-to’ introduction for anyone new to NEAR. It should include:
- What is NEAR?
- What can I do with my NEAR?
- How Does NEAR Work (Account model/token etc - link to White Paper)
- Why NEAR?
The NEAR Ecosystem
- Brief overview of what it is and what it offers
- Links to dApps (maybe just AwesomeNEAR?)
- Directions on how to start building (link to parts of the Engage section?)
A collation of the most frequently asked questions
A collation of off-Wiki resources which expand on all things NEAR.
Connecting with NEAR
An overview of how readers can get involved directly with NEAR Protocol, suggestions to include:
- Links to all relevant communities
- CTA to join
- Touch on Guilds (more on that later)
- What’s in it for those who join?
The NEAR Community
A more in-depth piece on what the NEAR Community is and where it’s based:
- What is the NEAR Community?
- How can I join?
- Why shouldI join?
Guilds on NEAR
- What’s a Guild?
- Why should I join a Guild?
- How can I join a Guild?
- How can I start a Guild?
- Guild Guidebook
- Funding requests etc
Build on NEAR
Details on grants and funding, as well as relevant technical documentation (or redirects to specific parts of the Wiki/tech docs).
This is being built out by the NEAR Legal Guild (h/t) and the internal legal team at NF.
Hoping a gigabrain techie can assist with this part rather than us having to just collate all existing info (though that works, too!)
How NEAR Works
Overview of the protocol and how it functions. Would be great to mention sharding.
Link to White Paper
Just a link embedded in Gitbooks on navigation bar to WP
Link to Documentation
Just a link embedded in Gitbooks on navigation bar to technical docs
Majority of this documentation is complete so we can just port this over. You can find it in the
Network section of the current Wiki.
NEAR Needs You!
If you want to contribute to the NEAR Wiki and be rewarded for it, come and join us in the NEAR Portal Guild Telegram channel or respond to this post.
I’ll be rolling out a style guide next week, but if you want to get started sooner then FEEL FREE!
The above content plan is not exhaustive and it could definitely do with being built on with your feedback.