search

bitcoinj / bitcoinj.github.io

source-code for the bitcoinj website, published at bitcoinj.org
https://bitcoinj.org
20 stars 36 forks source link

"Getting started" exists as both an anchor/section of main page and as standalone page. #10

Open msgilligan opened 9 years ago

msgilligan commented 9 years ago

This is confusing for new users when navigating the site.

msgilligan commented 9 years ago

Perhaps the "Getting Started" page should be renamed to "Tutorial"

msgilligan commented 9 years ago

To be more specific my suggestion here is to leave the "Getting Started" section (anchor) on the main page, but to rename the "Getting Started" tutorial pages to "Tutorial".

If I get feedback that this is the right way to go I'll create a pull request for that change.

mikehearn commented 9 years ago

Sounds good!

msgilligan commented 9 years ago

I would like to actually rename the files/urls from getting-started* to tutorial*, but unless something has changed, Github pages doesn't support redirects. So please let me know whether you think the "Information Architecture" benefit is greater than the potential broken links and temporary search engine issues.

mikehearn commented 9 years ago

Probably not. I doubt the current layout is that confusing. Though redirects can be simulated with HTML and a meta redirect tag.

msgilligan commented 9 years ago

OK, I'll leave the file/url names unchanged. We can always change them later and use the meta redirect if we change our minds.

msgilligan commented 9 years ago

Making this look right is a little trickier than I thought. For one, I need to install and learn how to use Jekyll locally to try out various options. I'm also thinking that a big part of the confusion here is that the top navigation doesn't change when you visit the tutorial pages or any of the documentation pages. I don't know how hard that would be to change using Jekyll.