Hi @David_NEAR ,
Thanks for driving this effort, it’s definitely important to make wiki into a powerful onboarding tool.
First question - is this already migrated to Docusaurus? Currently it still says there “Powered by GitBook” while NEAR Wiki Development Plan - Feedback Requested! says the migration will be done by Nov 22.
TLDR: I find current structure very confusing and really hard to find information. Some information is missing. Links are broken. Content has typos.
Starting from landing page:
Previously we had explanation of what is NEAR, why NEAR and some major directions to go next to explore Wiki.
Right now it has almost no information and super unclear where to go from here.
The sections like “Create and Learn” doesn’t really make sense to me.
Section like “Community” would make sense only later after I already familiarized myself with NEAR, not as a first thing.
Going 3 level in to just get a link make no sense to me.
At least provide information that person can read vs linking to external docs and blogs. People have come to Wiki and would like to get the summary of everything here.
Generally, I would prefer to reduce level of depth to max 2.
I personally liked way more having major sections with visible subsections under them vs ones that open - meaning I need to click on stuff to find what is there (because names of sections like aspirational Learn is not very clear). I’m ok if there is a clear study we have that this structure is better though.
For https://wiki.near.org/general/overview/near-token/token-balance – unclear why are we actually showing the RPC request to the user? I would not expect people reading Wiki know what this means.
Instead bringing more information to https://wiki.near.org/general/overview/near-token and removing extra indirection doing it would be great.
Similarly just bring main info into https://wiki.near.org/validators-and-staking/validators vs creating a separate indirection and require extra click. Plus this page right now linking to non existing pages. Also this info (validator economics, hardware, etc) should be on the wiki in the first place anyway.
There is no Stake Wars right now. It’s a different program. https://wiki.near.org/validators-and-staking/about#stake-wars-testnet
Also it’s worth improving the titles of pages , as they currently show up just as “About” for links like https://wiki.near.org/validators-and-staking/about#stake-wars-testnet
Generally, I agree on reducing the number of sections to way lower than what happened before. From my perspective:
- General: covering everything from why NEAR, basics of NEAR like account model and token, and any other FAQ people have,
- Engage (what ways engage with NEAR: guilds, projects, education, etc. This is where will be a guide how to start a project on NEAR, and what are ways to leverage NF, legal considerations and etc.
- Technology (this starts with how NEAR works and goes into how things are built, research and more),
- Validators (fixing content but otherwise is fine) and
“NF Public Docs” section makes little sense to me here. It’s content should go into one of the sections above. The reality that projects don’t really care about NF - they care about their success so that content should live in sections of how projects will be successful.