bitcoinj.github.io icon indicating copy to clipboard operation
bitcoinj.github.io copied to clipboard

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

Open msgilligan opened this issue 10 years ago • 7 comments

This is confusing for new users when navigating the site.

msgilligan avatar Jan 03 '15 01:01 msgilligan

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

msgilligan avatar Jan 03 '15 02:01 msgilligan

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.

msgilligan avatar Jan 05 '15 00:01 msgilligan

Sounds good!

mikehearn avatar Jan 05 '15 11:01 mikehearn

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.

msgilligan avatar Jan 05 '15 16:01 msgilligan

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

mikehearn avatar Jan 05 '15 16:01 mikehearn

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 avatar Jan 05 '15 17:01 msgilligan

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.

msgilligan avatar Jan 07 '15 08:01 msgilligan