Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

The docs site is all kinds of messed up! #102

Open
6 tasks
modster opened this issue Apr 10, 2022 · 2 comments
Open
6 tasks

The docs site is all kinds of messed up! #102

modster opened this issue Apr 10, 2022 · 2 comments

Comments

@modster
Copy link

modster commented Apr 10, 2022

It seems its been that way for quite a while now. I could look into it and do a pull request if there's nobody else to do it...

There's plenty more too, but I think the solution will be something simple, probably has something to do with keybase.io/docs being redirected to book.keybase.io.

@heronhaye
Copy link
Contributor

Hi,
We've fixed the 1st, 2nd, and 5th issues. I'm not sure what you mean by the 3rd, 4th, and 6th ones. Can you clarify? Thanks.

@modster
Copy link
Author

modster commented May 6, 2022

Wow! So that's how the site is supposed to look. Much better. Thanks!

Clarifications:

Issue 3: Try clicking on the "Guides" link in the TOC:

Screenshot 2022-05-05 211856

This happens:

Screenshot 2022-05-05 212028

Issue 4:
The docs appendix appears to contain outdated documentation. For instance:
https://book.keybase.io/docs/server#next-steps
Screenshot 2022-05-05 233141

That confused me because I hadn't read the section about stellar yet. Then I fumbled around some more:

Screenshot 2022-05-05 220845

And I knew something was wrong when I saw this:

Screenshot 2022-05-05 221543

The rest of the page is like that.

The docs appendix has a different look and feel to the rest of the site. The menus here look like this and have a chapter called Bots:

Screenshot 2022-05-05 222246

But then elsewhere the look is like this, and no "Bots", and "Guides" is back:

Screenshot 2022-05-05 222835

And at the risk of sounding like a knitpicker, the footer is wonky sometimes:

Screenshot 2022-05-05 223310

I think this project is pretty cool! I read all the documentation, even the stuff from ten years ago. Even with my litited understanding, it seems to me Keybase does blockchain better than most blockchain projects do blockchain. It's perfect for NFTs.

Keep up the good work! Let me know if you need a hand with the docs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants