Nothing Special   »   [go: up one dir, main page]
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.

Sign up for GitHub

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

Jump to bottom

Add non-technical "Getting Started" header #58

Open
bnvk opened this issue Nov 5, 2016 · 2 comments
Open

Add non-technical "Getting Started" header #58

bnvk opened this issue Nov 5, 2016 · 2 comments

Comments

@bnvk
Copy link
Member
bnvk commented Nov 5, 2016

When I had the idea & registered the domain name for indiewebify.me the idea was to make an easy tool to achieve the following:

  • More step by step interactive documentation on crucial components
  • Allow people developing Indie Web capable applications to test their site/code

It seems I picked a domain name that's too user friendly, as those above goals assume a certain technical baseline. At the Berlin camp multiple people who are non-technical and wanting to "get on the IndieWeb" seemed confused by IndieWebifyMe.

I suggest we had a small header and links that explain this and offer links to Getting Started or something slightly more user friendly that even.
@aaronpk
Copy link
Member
aaronpk commented Nov 6, 2016

I would love to see it made even simpler.

Notice that everything under "Level 3" is just a wall of text, not even any tools. I suspect that's part of what's confusing people.

You can also link out to other tools like https://webmention.rocks and https://micropub.rocks to send the more technical people to those specific tools once they're ready to dive in.

@Zegnat
Copy link
Member
Zegnat commented Nov 6, 2016

It might also not help that IndieWebify.Me is the first thing on “Getting Started”. And the first thing most of us will point at.

You can also link out to other tools like https://webmention.rocks and https://micropub.rocks to send the more technical people to those specific tools once they're ready to dive in.

Some confusion about Webmention.rocks came up in Berlin as well. After installing a Webmention plugin for WordPress someone (sorry for forgetting names!) wanted to see if it was working. They went to Webmention.rocks for their testing and were confused about what to do with the links.

It looks like we need to make a difference between implementor tests and user tests. (There was a lot of discussion about users.) As an implementor I want detailed separate tests. As a user I just want to enter my domain somewhere and be done with it.

A good example of the latter is Google’s MX record checker. The page only has the single input box: https://toolbox.googleapps.com/apps/checkmx/.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
None yet
Milestone
No milestone
Development

No branches or pull requests
3 participants
@bnvk @aaronpk @Zegnat