forsaken

I'm one of the maintainers of readthedocs and would love to integrate something like this. We have somewhat integrated support for linking to GitHub as an editor, but that is only a half-baked solution.

Groove Salad is the best music that I have found that I can work consistently to. Definitely recommend checking it out if downtempo electronic music is your preferred work music.

Sure, keep the files as plain text in the repo, I'm all for that. Just don't make it the main interface for viewing them. You are really arguing that a GitHub file browser is the best UX for viewing documentation?

Sure, keep documentation about code in the source code. Where exactly in the source code does your tutorial go?

You seem to be reading into a lot of things that aren't in the article based on what you want to hear.

The article isn't saying to write things in another language as canonical, it's just saying put the language in the URL so later you can add other languages without breaking the URL.

I think that is what you are advocating in part of your response.

However, Sphinx & Read the Docs is not just for Python :)

http://ericholscher.com/blog/2014/feb/11/sphinx-isnt-just-fo...

A good host will redirect to the proper version of the docs when presented with a root URL, but how do you link someone to a specific language, if the Accept-Language is the canonical source for this information?

Great information for how to write a press release, as well.

Have you written more at length about this? I often find it incredibly hard to convey these points, and having stories or at least anecdotes that are relatable to people is usually the best tactic.

Looks like a great bunch of talks. Thanks to everyone who helped put the schedule together. The entire staff that puts on Pycon every year is all volunteer, and generally takes quite a bit of time to get it all put together.

Those same arguments would apply to Python too, and it doesn't seem to have nearly as much cruft.

That's classified.

I find it hard to believe it's Enterprise-grade when the documentation link points at a GitHub README.

Thanks for the perspective. Understanding how things are perceived by others is an incredibly hard thing to do.

Seems to be missing documentation.

As someone who worked on an Open Source project for years with no compensation, adding sustainable funding to it was very motivating. Money is a very weird thing, but getting money for the continued existence of your work is fantastic validation and support.

It's easy to work on things for free, but how do you know that people value them if they simply use them for free. Attaching money to a pursuit that was previously free can also act to greatly encourage the continued existence of the project in the face of burnout and uncertainty.

A fantastic video along the same lines: http://www.youtube.com/watch?v=k7X7sZzSXYs

It's the expectation of the user that this is hacking. Inserting the HTML into a non-Intro user's email wouldn't make sense. But sense the user is expecting that data, and for it to be validated, spoofing it becomes much more valuable.

It makes me sad that interacting with a community has to come with disclaimers :x

Yea, that. The python bit was just a side note.

I went ahead and removed the python part, as it didn't really contribute to the message.

I just wanted to point out how poisonous our community is. It's something that I've been struggling with for a long time, and trying to slowly change.

The fact that people read this article, and don't feel the need to mention his fear of releasing software just shows how broken things are. It shouldn't be an accepted fact of open source that if you release new code that might be backwards incompatible, you get vitriol for it.

His quote:

... but I too cowardly to release it and make it mainstream, as Im afraid it'll destroy whatever good will for open source I have left when the flood of support questions inevitably comes in, followed by all the people who are unhappy with what I've built and feel obliged to tell me how bad I am at software.

Or just give them money on something like gittip. Things like this need to be sustainable, not just a flash in the pan of $10k, then going back to having nothing.

I think you missed the point.

He was poking fun at the current culture by calling him a "content creator".

I saw this talk in person, and it was obvious in that context.

Just because you own something doesn't mean its a liquid asset..

I'm using it non-production things, and have had a similar experience. I'm in the SFO data center, and I've lost connectivity to the machine at least 5 times in the past month.

It saves money. That's at least one advantage.

Did the NYTimes just break a story about one of their own employees leaving? The tone of the article is really interesting.

Imagine if something like this allowed them to quit their jobs, so that they did need this money, and work on open source projects full time. That's the goal.

I think you read it correctly. The opening song in the Painting Coconuts video is one of my favorites currently. This bodes well :)

Thanks for more inspiring videos. The man who plants trees was amazingly apropos because of my recent departure from a promised life in the woods. However, inspiration is always valuable.

Thanks for this comment. It led me to read the entire website that you linked. On a page I found a link to The Man Who Planted Trees.

I was walking across the country recently on the Pacific Crest Trail, and I had to come off the trail because of an injury. I have been looking around listlessly at the world, and trying to figure out what to do.

This video has struck me in an interesting way. It shows someone who is true of heart can find happiness in profound ways. It has also helped me re-imagine art, as the man painted the landscape and changed the feeling of a region.

It is a beautiful example of the change a single person can make.

Earlier today, I was tempted to tweet "What would a present day John Muir look like?" -- Interestingly I found an answer by another avenue.

A docstring is not a comment. A docstring is actually a string that gets saved on the object, where as a comment is not used at all.