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

Add developer portal #1887

Merged
merged 1 commit into from
Apr 21, 2016
Merged

Add developer portal #1887

merged 1 commit into from
Apr 21, 2016

Conversation

paulproteus
Copy link
Collaborator

Close #1881

More specifically:

  • Change mention of app developer tutorial in README to instead
    link to developer portal.
  • Add a flexbox grid at the top of /developing/ for quick access
    icons to next steps, to make it feel more like a "developer
    portal" (cc: @jadeqwang), supported by docs/extra.css

While I was at it:

  • Move the documentation explaining the vague overall design goals
    of vagrant-spk from docs/vagrant-spk/index.md into the existing
    file, docs/vagrant-spk/customizing.md which allowed me to delete
    docs/vagrant-spk/index.md entirely.
  • Adjust the packaging tutorial to say that some parts might be slow
    due to download times.
  • Drastically improve (in my opinion) the amount of information, and
    its contextualization, within the Developer Portal. Up until now,
    Cap'n Proto was not even mentioned once.
  • Update commented-out TODO items to indicate that some docs have now
    been written.

Close #1881

More specifically:

- Change mention of app developer tutorial in README to instead
  link to developer portal.

- Add a flexbox grid at the top of /developing/ for quick access
  icons to next steps, to make it feel more like a "developer
  portal" (cc: @jadeqwang), supported by `docs/extra.css`

While I was at it:

- Move the documentation explaining the vague overall design goals
  of `vagrant-spk` from `docs/vagrant-spk/index.md` into the existing
  file, `docs/vagrant-spk/customizing.md` which allowed me to delete
  `docs/vagrant-spk/index.md` entirely.

- Adjust the packaging tutorial to say that some parts might be slow
  due to download times.

- Drastically improve (in my opinion) the amount of information, and
  its contextualization, within the Developer Portal. Up until now,
  Cap'n Proto was not even mentioned once.

- Update commented-out TODO items to indicate that some docs have now
  been written.
@paulproteus
Copy link
Collaborator Author

Screenshot of what this looks like. Going to self-merge now since this is 100% docs.

@neynah you might have thoughts and I'm happy to take time to respond to them. I made some guesses as to which image made sense; @neynah if you want to propose new images, I 100% endorse any suggestions you make, but I also think this is OK as-is for now.

screenshot from 2016-04-21 14 17 59

@paulproteus paulproteus merged commit 330763b into master Apr 21, 2016
@paulproteus paulproteus deleted the add-developer-portal branch April 21, 2016 21:28
@paulproteus
Copy link
Collaborator Author

https://docs.sandstorm.io/en/latest/developing/ is the live page.

@neynah
Copy link
Collaborator

neynah commented Apr 21, 2016

Nice! Yeah, I'll see if I can fix up some of the icons today. "App Market" should be capitalized andlon most screens the icons & text should be displayed as 2 rows of 3. That probably just requires making them larger. I don't mind making these tweaks myself. :)

@paulproteus
Copy link
Collaborator Author

paulproteus commented Apr 21, 2016 via email

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

Successfully merging this pull request may close these issues.

2 participants