neorg icon indicating copy to clipboard operation
neorg copied to clipboard

Add neorg file reference and docs to wiki page

Open Hoverth opened this issue 1 year ago • 3 comments

Issues

  • [X] I have checked existing issues and there are no existing ones with the same request.

Feature description

Hello, As a newcomer, the documentation seems to be directed mainly at developers and/or power users, and after going through the repo and finding the doc/*.norg files (which are a great reference by the way), I was wondering if they could be more directly linked to or embedded in the wiki?

Help

Yes, but I don't know how to start. I would need guidance.

Implementation help

How are GitHub wiki pages edited? I may be able to figure it out, but some pointers would definitely be appreciated.

Hoverth avatar Apr 18 '24 03:04 Hoverth

@Hoverth the stuff in doc/ is for help pages. :h neorg will show you neorg.norg and the cheatsheet file is supposed to show up for :h neorg-cheatsheet but the tags are broken I think

benlubas avatar Apr 22 '24 16:04 benlubas

I believe those do work, just as someone new coming into neorg, I did not know that they were there without watching vyrro's videos on neorg.

I'm primarily suggesting that there is something in the README.md or wiki to point new users to those commands and/or files, just to improve accessibility and prevent confusion from newcomers.

Hoverth avatar Apr 23 '24 01:04 Hoverth

I've just gone through the wiki, and this time I've managed to find the tutorial page, so there is a reference to the norg file format. Maybe I was just too tired when setting neorg up that I missed it, or it's a bit out-of-the-way.

I do however suggest that the :h Neorg command be listed somewhere in the wiki, as I can't seem to find it at the moment, and it was a great help to me.

Hoverth avatar Apr 23 '24 01:04 Hoverth