Rate My Docs

Dev tools

documentation quality scoring

SHOW HN2017

12points
3comments
#1,602of 2,242 in 2017
Top 72%of 2017 by points

How HN took it

QuietFewer than 5 comments about the project

0 positive, 1 neutral or asking, 0 mixed, 2 critical, out of 3 comments about the project.

Idea: 0 for, 2 against

The thread, comment by comment

Each row is a top-level comment and its replies, in HN's order. Select a cell to open that comment on HN.

positive neutral or mixed critical about another commenter or something else the maker

What HN said

Objections

  • Scoring questions are odd and irrelevant to real developer helpfulness

    From 2 comments
    • Really irrelevant set of questions to judge your documentation. Nothing about measuring how much your documentation helps developer. Having a SDK doesn't really make it friendly…
      codegladiator on HN
    • This is cool and all, but I got a 25 on my docs thanks to their odd criteria and questions. I think my docs are well above the 'average' docs, but maybe not. Originally, I…
      ezekg on HN
  • Input is manual; cannot paste a docs link for automatic rating

    From 1 comment
    • At first I thought I could paste in a link to my docs but then I realized it was manual so I bailed.
      dharness on HN
  • Pricing is too high for small teams

    From 1 comment
    • This is cool and all, but I got a 25 on my docs thanks to their odd criteria and questions. I think my docs are well above the 'average' docs, but maybe not. Originally, I…
      ezekg on HN

Requests

  • Lower pricing tier

    From 1 comment
    • This is cool and all, but I got a 25 on my docs thanks to their odd criteria and questions. I think my docs are well above the 'average' docs, but maybe not. Originally, I…
      ezekg on HN

Alternatives named

  • Static site hosted on GitHub Pages

    From 1 comment
    • This is cool and all, but I got a 25 on my docs thanks to their odd criteria and questions. I think my docs are well above the 'average' docs, but maybe not. Originally, I…
      ezekg on HN

Category, keywords, summaries and labels on this page were made by AI (Thread Reader v2) and not checked by hand. Each point links to the comments it came from.

Add a badge to your READMEShown on HackerShow
[![Shown on HackerShow](https://hackershow.org/badge.svg)](https://hackershow.org/show/15083310)