Correct way of contributing to MWS docs

[bobjoe12131]

I opened up the docs to look for the term "entity" and got

2025-02-18 - User Management
Application Access & Security

I would like a simple "entity" article so I can get straight to the meaning.
What is the right way to edit the docs? Do i have to go in the code, edit the md file, and manually set the last used in the metadata? Do i use the web UI? I dont know a lot about MWS, can i make a tiddler with a term and simple description instead of a full article? I want to make a small tiddler and create links from things that mention the tiddler, to the tiddler.

Some of the tiddlers are streams of concepts that could be split into their own tiddlers (or make a word a link to the to the relevant tiddler) . Are these articles destined to be conceptifed, or is it meant to be as it is because it is a docs wiki?

[Arlen22]

I'm assuming you have the repo cloned and running?

Start the server with npm run docs and then navigate to /dev/mws-docs.

[bobjoe12131]

On an init-stored project, logged in as admin, _{I forget your instructions and write everything in the regular recipe. After only pushing a lock json, I go back to read your instructions.}
I run npm run docs and go to http://10.0.0.170:8080/dev/mws-docs (phone ip) to get a blank page and

console

XHRPOST
http://10.0.0.170:8080/admin/index_json
[HTTP/1.1 400 Bad Request 57ms]
mount Error: Failed to fetch data for /admin/index_json:

Mr utils.tsx:102

NI utils.tsx:143

PB main.tsx:28

h utils.tsx:40

rc useAsyncEffect.tsx:64

rc useAsyncEffect.tsx:85

React 3

Sg scheduler.production.min.js:13

vg scheduler.production.min.js:14

Fb scheduler.production.min.js:14

p chunk-YALWN5OT.js:1

b index.js:4

p chunk-YALWN5OT.js:1

zS React

p chunk-YALWN5OT.js:1

Yd React

p chunk-YALWN5OT.js:1

qS React

p chunk-YALWN5OT.js:1

 main.tsx:2

useAsyncEffect.tsx:5:30

Uncaught (in promise) Error: Failed to fetch data for /admin/index_json:

Mr utils.tsx:102

NI utils.tsx:143

PB main.tsx:28

h utils.tsx:40

rc useAsyncEffect.tsx:64

rc useAsyncEffect.tsx:85

React 3

Sg scheduler.production.min.js:13

vg scheduler.production.min.js:14

Fb scheduler.production.min.js:14

p chunk-YALWN5OT.js:1

b index.js:4

p chunk-YALWN5OT.js:1

zS React

p chunk-YALWN5OT.js:1

Yd React

p chunk-YALWN5OT.js:1

qS React

p chunk-YALWN5OT.js:1

 main.tsx:2

utils.tsx:102:23

[Arlen22]

You have to do it in the dev repo that you cloned from GitHub. You can't do it in an inited project.

https://github.com/TiddlyWiki/MultiWikiServer?tab=readme-ov-file#development

git clone https://github.com/TiddlyWiki/MultiWikiServer
cd MultiWikiServer
npm install
npm start init-store
npm run docs

[bobjoe12131]

"i did it right"

Sorry, i should have described in more detail. The first attempt above, i cloned my fork and checked out a branch that was synced to this repo. I am pretty sure i was using a git version of MWS as i was able to `git add .` and `git push` a lock json file. Maybe i did have another session in the directory of a NPM version and mixed that up, but i don't think so.

In a new directory, I run the commands one by one on my phone (with install-android instead), login, and go to http://127.0.0.1:8080/dev/mws-docs on mobile firefox. Blank page. I go on mobile chromium, login, blank page.
I repeat the steps, but on my linux laptop. On firefox on the laptop, I login and go to http://[::1]:8080/dev/mws-docs to get a blank page and

console

XHRPOST
http://[::1]:8080/admin/index_json
[HTTP/1.1 400 Bad Request 6ms]
mount Error: Failed to fetch data for /admin/index_json:

Mr utils.tsx:102

NI utils.tsx:143

PB main.tsx:28

h utils.tsx:40

rc useAsyncEffect.tsx:64

rc useAsyncEffect.tsx:85

React 3

Sg scheduler.production.min.js:13

vg scheduler.production.min.js:14

Fb scheduler.production.min.js:14

p chunk-YALWN5OT.js:1

b index.js:4

p chunk-YALWN5OT.js:1

zS React

p chunk-YALWN5OT.js:1

Yd React

p chunk-YALWN5OT.js:1

qS React

p chunk-YALWN5OT.js:1

 main.tsx:2

useAsyncEffect.tsx:5:30

Uncaught (in promise) Error: Failed to fetch data for /admin/index_json:

Mr utils.tsx:102

NI utils.tsx:143

PB main.tsx:28

h utils.tsx:40

rc useAsyncEffect.tsx:64

rc useAsyncEffect.tsx:85

React 3

Sg scheduler.production.min.js:13

vg scheduler.production.min.js:14

Fb scheduler.production.min.js:14

p chunk-YALWN5OT.js:1

b index.js:4

p chunk-YALWN5OT.js:1

zS React

p chunk-YALWN5OT.js:1

Yd React

p chunk-YALWN5OT.js:1

qS React

p chunk-YALWN5OT.js:1

 main.tsx:2

utils.tsx:102:23

[bobjoe12131]

waitwaitwait nevermind. I just had to remove the /dev/ part of the url. for some reason i don't need the dev part ever when i run MWS git. Im going to try again.

I think this is more of an #82 problem as i went to a gibberish url and it gave the same console text.