Y
HN Search
Hacker News Search
new
|
comments
|
top
|
jobs
forsaken
searching PlanetScale…
1.
▲
2.
▲
3.
▲
4.
▲
5.
▲
6.
▲
18 ms
·
31.
▲
by
forsaken
9y ago
Are they behind the schedule they quoted you when you reserved it?
32.
▲
by
forsaken
9y ago
Like folks giving money to open source projects? You should apply for a Mozilla OSS award ( https://wiki.mozilla.org/MOSS ) -- deadline is July 31!
33.
▲
by
forsaken
9y ago
Python also has a similar concept: https://docs.python.org/2/library/doctest.html Sphinx also has additional doc testing methods that let you test the code examples in your actual docs: http://www.sphin
34.
▲
by
forsaken
9y ago
I have the same issue with Quora. Makes me sad every time I go there and find useful info, but feel pushed away. Dropbox also does similar -- in fact they broke all their old direct public links, so that you can use their new "sharing&
35.
▲
by
forsaken
10y ago
This makes me sad. We based our Ethical Advertising concept that we're doing on Read the Docs ( http://docs.readthedocs.io/en/latest/ethical-advertising.htm... ) on their inspiration. We don't have nearly
36.
▲
by
forsaken
10y ago
He might know how to fly a helicopter :)
37.
▲
by
forsaken
10y ago
Yea, I mention commonmark in the post, and referred to it in the "standard that was used" part -- commonmark is great, but wasn't widely adopted. Updated my original post to be more clear.
38.
▲
by
forsaken
10y ago
This is great -- lack of a standard that was actually used (unlike CommonMark) was one of my main issues with Markdown ( http://ericholscher.com/blog/2016/mar/15/dont-use-markdown-f... ) -- It's reall
39.
▲
Read the Docs 2016 Stats
(blog.readthedocs.com)
2 points
by
forsaken
10y ago
|
0 comments
40.
▲
Ethical Advertising – Read the Docs
(docs.readthedocs.io)
1 points
by
forsaken
10y ago
|
0 comments
41.
▲
Security vulnerability in str.format in Python
(lucumr.pocoo.org)
3 points
by
forsaken
10y ago
|
1 comments
42.
▲
by
forsaken
10y ago
Thanks. This should now be fixed.
43.
▲
by
forsaken
10y ago
readthedocs.org -- A site that automatically builds documentation for you when you commit to your VCS repo. It's been widely used in the Python ecosystem for a few years now, and started off as a 48 hour hack day project.
44.
▲
by
forsaken
10y ago
I imagine it would work like a CLA in a lot of company sponsored open source. You retain copyright, but allow the owner to distribute it under their specified license terms. Or you could have a CLA that actually assigns copyright. The ongoi
45.
▲
by
forsaken
10y ago
Is that not better than adopting a more classic proprietary model where the source code isn't available? I totally agree with the philosophical argument around OSS --but at the end of the day, people need to eat. If you're going t
46.
▲
by
forsaken
10y ago
The project is still in the development stages. More info here: http://pybee.org/ -- with this page being useful for starting off: http://pybee.org/project/using/ I don't think there is a &qu
47.
▲
by
forsaken
11y ago
You can do code blocks:: like this :)
48.
▲
by
forsaken
11y ago
Curious how you cross-referenced across the books? Did you do listings of API's? Markdown is great for text content, not for formal documentation.
49.
▲
Advertising on Read the Docs Community Sites
(blog.readthedocs.com)
1 points
by
forsaken
11y ago
|
0 comments
50.
▲
Read the Docs awarded MOSS grant from Mozilla for PyPI integration
(blog.readthedocs.com)
1 points
by
forsaken
11y ago
|
0 comments
51.
▲
Read the Docs and Sphinx Now Support Commonmark
(blog.readthedocs.com)
4 points
by
forsaken
11y ago
|
0 comments
52.
▲
by
forsaken
12y ago
Another option is Read the Docs, which is how we host the Write the Docs docs: http://docs.readthedocs.org/en/latest/ -- It's basically the above workflow that GitHub describes, but with Sphinx ( http:/&
53.
▲
by
forsaken
12y ago
Or get 50-200% back with a higher bar for entry (already having revenue, only needing 200% investment back out in 2 years)
54.
▲
by
forsaken
12y ago
This is really interesting. I have been having conversations with a bunch of folks in the Portland area about trying to find funding with a very similar model. Glad to hear that other folks are thinking, and doing things, along these lines.
55.
▲
by
forsaken
12y ago
http://en.wikipedia.org/wiki/Prohibition_in_the_United_State...
56.
▲
by
forsaken
12y ago
Interestingly, Django also came out of Kansas :)
57.
▲
by
forsaken
12y ago
I believe his commitment is to free software, not open source :)
58.
▲
by
forsaken
12y ago
We haven't had much contact with the STC. Their meetups generally cost money, and are focused on DITA and more "old school" XML based technology. We are trying to bring the world of devs who care about docs to the doc writers
59.
▲
by
forsaken
12y ago
A lot of the experience from writing this has come from running Read the Docs: https://readthedocs.org/ -- which we've been hosting OSS docs built this way for over 4 years. We're taking these ideas and building a
60.
▲
by
forsaken
12y ago
The beginners guide is explicitly using general markup, instead of Sphinx specifically. Almost none of the content on the site is actually Sphinx-specific..
More ›