-
Notifications
You must be signed in to change notification settings - Fork 28
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
Refactor/split up get started #414
Conversation
…ent into seperate pages in 'Build' section
e232eb7
to
009f61a
Compare
Seems like a solid move; I'd like to suggest a slight rejiggering:
|
But its not conceptual -- its specific to developers actually building apps. I feel like concepts should be purely for understanding holochain not using it. When someone is installing the dev tools they've moved solidly into using it. I don't think deployment and packaging belongs in "getting stated" -- I think it deserves it's own page. There's going to be a lot more content needed related to packaging, distribution and updating. That said I don't have the bandwidth to go back and forth, so I'm happy to let you make the changes you want to this PR and get it merged. |
I appreciate your engaging when you don't have much bandwidth, and I don't want to pull you away too much more. Can I ask one more question though? I'd like clarification on
So the way I see it, 'Get Started' is all about taking action and starting to use the dev tools (but before you're getting into serious dev work). It isn't currently under Core Concepts, though (which is 100% conceptual) -- maybe that's why the confusion?
100% agree; not sure why it's there right now. |
ah sorry my bad -- yes all your suggestions make sense to me |
e2041e2
to
de96bda
Compare
This looks good to me now. I would like to get a third set of eyes on it, but I'm not sure who to bring in. @matthewjosef ? @marycamacho ? The tl;dr for this change is that the getting started guide is getting broken up into four pages to make it more digestible. |
@matthme could you re-review the changes in the last commit, to see if I'm describing your kangaroo repos accurately? Thanks 🙏🏼 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I do feel like these pages probably don't belong under "Getting Started", but that can wait until we have the start of a "Build" section:
Distribute your App
Holochain Upgrade 0.1 → 0.2
Setup For a Local Event
Otherwise looks good -- so much more legible IMO.
yeah, those definitely need to move @mattyg -- I was gonna wait until we had a build guide, then create a howtos section. Although... does 'set up for a local event' feel like it belongs under build? not sure. |
Overview
Core Concepts > Get Started
page into multiple separate pagesBuild > Index
Build > Forum App Tutorial
Build > Deployment & Packaging
Next Steps
section