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

Docs Revamp Part 1/2: (Re)moving Pages #382

Merged
merged 24 commits into from
Oct 24, 2024
Merged

Docs Revamp Part 1/2: (Re)moving Pages #382

merged 24 commits into from
Oct 24, 2024

Conversation

derrekcoleman
Copy link
Contributor

@derrekcoleman derrekcoleman commented Oct 14, 2024

See "Docs Revamp" on Notion in lieu of a GitHub Issue.

This PR is a "major version" bump to BOB's documentation.
Part 1/2 focuses on rm and mv changes, saving new content for Part 2/2.

Goals

  • Make our docs up-to-date, concise, and well-organized so users can easily find the correct answer to their question.
  • Create, update, and remove pages to be laser-focused on our current narrative (UX and yield for Bitcoiners), roadmap (BitVM), and product strategy (Gateway).
  • Create redirects for all moved pages.

High-level Changes in Part 1/2: (Re)moving pages

  • Remove “Contracts” section entirely
  • Merge “Learn” and “Build” into one section
  • Delete or consolidate pages that are out of date or out of scope to BOB’s current roadmap
  • Delete or consolidate high-level pages related to Bitcoin development, but not directly connected to BOB (e.g. Local Development and Bitcoin Testing)
  • Remove current landing page; instead, start at an “Introduction”-style first page (i.e. a page at the top of the sidebar)

Sidebar Sections Before Changes

Screenshot 2024-10-14 at 6 04 28 PM Screenshot 2024-10-14 at 6 04 42 PM Screenshot 2024-10-14 at 6 05 10 PM

@derrekcoleman derrekcoleman added the documentation Improvements or additions to documentation label Oct 14, 2024
@derrekcoleman derrekcoleman self-assigned this Oct 14, 2024
Copy link

changeset-bot bot commented Oct 14, 2024

⚠️ No Changeset found

Latest commit: 9c28d4b

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Copy link

vercel bot commented Oct 14, 2024

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
bob ✅ Ready (Inspect) Visit Preview 💬 Add feedback Oct 24, 2024 0:15am

Create the new "BOB" folder at /introduction
Move some files to /to-be-deleted
Also includes Bitcoin dev section as a placeholder for merging those
pages
Breaks flat structure to make the sidebar more concise and elevate the
other pages in Reference that are more BOB-focused
docs/docs/learn/user-guides/contribution.md Outdated Show resolved Hide resolved
docs/docs/learn/introduction/roadmap.md Outdated Show resolved Hide resolved
docs/docs/learn/to-be-deleted/account-abstraction/index.md Outdated Show resolved Hide resolved
docs/docs/learn/to-be-deleted/meta-transactions/index.md Outdated Show resolved Hide resolved
docs/docs/learn/user-guides/_category_.yml Show resolved Hide resolved
docs/docs/learn/builder-guides/_category_.yml Outdated Show resolved Hide resolved
docs/docs/learn/builder-guides/_category_.yml Outdated Show resolved Hide resolved
docs/docs/learn/to-be-deleted/ethereum-bridge/index.md Outdated Show resolved Hide resolved
- Reorder pages within sections
- Bring back Ethereum bridge and BTC Gas pages
- Rename user guide pages to start with intent verbs
- Delete P2P swap page; move Hello Bitcoin to top
- Fix TODOs for broken links
Temporary workaround to desired state, which would be landing directly
on the root page of the sidebar instead of the intermediary landing
page.
@derrekcoleman
Copy link
Contributor Author

Remove current landing page; instead, start at an “Introduction”-style first page (i.e. a page at the top of the sidebar)

This has proven remarkably difficult. Instead, I updated the current landing page. Maybe we can do a server-side redirect as a workaround.

@derrekcoleman derrekcoleman marked this pull request as ready for review October 24, 2024 03:40
@nud3l
Copy link
Contributor

nud3l commented Oct 24, 2024

Remove current landing page; instead, start at an “Introduction”-style first page (i.e. a page at the top of the sidebar)

This has proven remarkably difficult. Instead, I updated the current landing page. Maybe we can do a server-side redirect as a workaround.

I think if you create a page in docs/learn/index.md, you'll get an intro page on the top level.

@nud3l nud3l merged commit 0ddc97c into master Oct 24, 2024
5 checks passed
@nud3l nud3l deleted the derrek/docs-revamp branch October 24, 2024 12:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants