On Mon, Aug 14, 2017 at 1:26 AM, <jkep...@gmail.com> wrote: > I'm not hugely excited about Google products in general due to their > corrosively broad erosion of privacy in society (same thing goes for > Facebook's platform in my opinion). >
No comment. > But given that you've found Google Docs efficient for producing quality > documentation, great. Having good documentation is really helpful. > It's unparalleled. Static documentation doesn't even come close. The advantages are two-fold it's the effective collaboration (theoretically possible collaboration is pointless if nobody ever sends a patch) and the immediacy of it (even I wouldn't bother loading up the file in Emacs and finding the trouble spot if I see a typo in the midst of doing something else). The problem with open source solutions is that users are programmers and focus their attention on the artifact (the file format), which is mostly irrelevant for the reader. The problem to solve is "How do I work to best to produce a relevant text?" "How do I know if what I wrote is unclear?" Innovation sometimes requires doing unusual things. I'm not one to follow the crowd, I think for myself (and the OSS crowd really is just another crowd, and in some areas, a very conservative one at that). Yes, it's weird for an open source project, but we've learned useful things from the experience. Nothing is perfect. However, I agree with Zhoyun Wei that I find the Google Docs solution > difficult to search against all the beancount documentation when I'm > looking for something. > > Is there an easy way to search beancount's documentation within Google > Docs? > AFAIK you can search from the Drive interface. Just add the word "beancount" and some terms. Thanks! > > Le dimanche 13 août 2017 19:16:29 UTC+2, Martin Blais a écrit : >> >> On Sun, Aug 13, 2017 at 12:15 PM, Zhuoyun Wei <wzy...@wzyboy.org> wrote: >> >>> Glad to hear Beancount moves on from Google Docs. >>> >> >> It's not. >> It would just be nice to have a conversion from Docs to something static, >> for people like you who don't like the Docs format. >> >> >> >> No offense. But I was very confused when I first met Beancount. Google >>> Docs is a very good collaborating platform but a poor choice for >>> software documentation. I remember when I needed to look up for some >>> syntax or usage I cannot search thru the documention because >>> "site:docs.google.com beancount" does not return any useful results [1] >>> -- it's very ironic that a search engine does not index its sibling >>> website well. The Docs page itself is slow to load compared to simple >>> HTML (without a ton of AJAX) or plain text documentation that were >>> popular among open source projects. >>> >>> Cheers! >>> >>> >>> [1] https://www.google.com/search?q=site%3Adocs.google.com+beancount >>> >>> >>> -- >>> Zhuoyun Wei >>> >>> -- >>> You received this message because you are subscribed to the Google >>> Groups "Beancount" group. >>> To unsubscribe from this group and stop receiving emails from it, send >>> an email to beancount+...@googlegroups.com. >>> To post to this group, send email to bean...@googlegroups.com. >>> To view this discussion on the web visit https://groups.google.com/d/ms >>> gid/beancount/20170813161509.GA3766%40xenien.wzyboy.org. >>> For more options, visit https://groups.google.com/d/optout. >>> >> >> -- > You received this message because you are subscribed to the Google Groups > "Beancount" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to beancount+unsubscr...@googlegroups.com. > To post to this group, send email to beancount@googlegroups.com. > To view this discussion on the web visit https://groups.google.com/d/ > msgid/beancount/e0c8829c-b45b-4095-98a6-4a127d0a2aa7%40googlegroups.com > <https://groups.google.com/d/msgid/beancount/e0c8829c-b45b-4095-98a6-4a127d0a2aa7%40googlegroups.com?utm_medium=email&utm_source=footer> > . > > For more options, visit https://groups.google.com/d/optout. > -- You received this message because you are subscribed to the Google Groups "Beancount" group. To unsubscribe from this group and stop receiving emails from it, send an email to beancount+unsubscr...@googlegroups.com. To post to this group, send email to beancount@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/beancount/CAK21%2BhPO7VCGV4W7o27aDg9TTG%2BaUrWyxosbS3_JB6QNNigffA%40mail.gmail.com. For more options, visit https://groups.google.com/d/optout.
