Broken links in FAQ - Githubissues

ssbc / handbook.scuttlebutt.nz

ssb handbook: A guide to the Secure Scuttlebutt key concepts and influences (see also, new website: https://gitlab.com/ssbc/scuttlebutt.nz/)

https://handbook.scuttlebutt.nz

167 stars 48 forks source link

Broken links in FAQ #140

Closed ergl closed 4 years ago

ergl commented 5 years ago

Hi! I was reading the FAQ and noticed there are a few links that are broken (they point to the markdown file, instead of the generated page).

I looked into the raw markdown source for the faq index, but couldn't point to anything that looked wrong.

I found a few that are broken, mainly:

How do new users join the system?
How do I reserve my user name
Why do you have pub servers? isn't that a point of centralization?
How does user identity work?
Is it possible to delete or edit messages?
How do we prevent harassment and spam?

stale[bot] commented 4 years ago

Is this still relevant? If so, what is blocking it? Is there anything you can do to help move it forward?

ergl commented 4 years ago

Not stale, still relevant. The issue stems from the fact that the pages are not found. For example, the onboarding file is not in the final html page. If one goes to the onboarding link, a 404 error appears.

It seems links will point to the markdown versions of pages only if a html version doesn't exist. Possibly related to https://github.com/ssbc/scuttlebutt.nz/issues/120#issuecomment-489924134, if the build step is failing, there will be stale pages in the final website.

stale[bot] commented 4 years ago

Is this still relevant? If so, what is blocking it? Is there anything you can do to help move it forward?