5 ms·
@ Document Your Project here's a good talk about it http://pyvideo.org/video/1795/write-the-docs http://pyvideo.org/video/1795/write-the-docs > bitbucket is a
by zalew 14y ago
@ Document Your Project
here's a good talk about it http://pyvideo.org/video/1795/write-the-docs http://pyvideo.org/video/1795/write-the-docs
> bitbucket is a good service, no doubt. But people who choose it for public code are just being difficult (according to me)
this argument is a pile of horseshit (according to me).
- hosay123 14y agoActually if you consider open source as proxy for the communication of ideas, writing docs might be seen as the primary goal of any project. Without docs expressing what code is supposed to do, a random git repo is just another worthless, opaque pile of buggy spaghetti to any random bystander. With docs, said bystander is empowered with the original intent, and might even extend your idea far beyond what you ever envisioned (aka "the power of open source"). A side point is that many people (myself included) will look for docs first, as some measurable proxy of code quality. Shitty docs often means shitty code or shitty idea.
- niggler 14y ago"this argument is a pile of horseshit (according to me)." Which part? Do you think bitbucket is not a good service or that bitbucket has reached a critical mass for open source hosting or that github hasn't reached a critical mass?