On Mon, Feb 1, 2021 at 6:54 AM Kirill Goncharov <[email protected]> wrote:
> I suggest switching to beancount/docs as a primary documentation source. > Everyone will be able to contribute to it, and no additional services will > be needed. Also, sooner or later gdoc conversion pipeline will stop working > so it's something to consider in any case. > I hope it continues working for a VLT! :-) For the new version, I have in mind a new, much better API documentation, with a dedicated set of public objects all rooted at the same package for the core objects. i.e. like numpy, but with "bn" instead of "np": import beancount as bn bn.load(...) inv = bn.Inventory() bn.Transaction(... bn.Posting(...)) etc. With all the objects neatly documented so that it's easier for people to work off the API and build things. > A knowledge base can't be a substitute for the mailing list / forum > though, it's a very different medium. > > > On Monday, February 1, 2021 at 5:49:44 AM UTC+3 [email protected] wrote: > >> Some people do the Discord thing. >> I find it too distracting. I don't have the time. >> Plus it's hit-or-miss when you show up whether the right people happen to >> me there or not. >> >> We probably should have some way for people to add / edit a shared KB. >> We've been working with Gdocs so far, not just me, but a few others as >> well. >> Would it be an improvement if I enabled the Wiki on the project? >> >> >> >> >> >> On Sun, Jan 31, 2021 at 8:37 PM Oon-Ee Ng <[email protected]> wrote: >> >>> On Mon, Feb 1, 2021 at 2:38 AM nug get <[email protected]> wrote: >>> >>>> Dear community, >>>> As a suggestion from my side, how about replacing this mailing group by >>>> a forum? >>>> >>>> pros: >>>> - potentially build a structured knowledge base that is helpful >>>> - user-generated how-to-content >>>> - control notifications >>>> - not spamming everyone with your new topic that might be interesting >>>> only to few people >>>> >>>> cons: >>>> -effort to set it up >>>> - ...? >>>> >>>> @Martin, in case you don't want to do the effort, would you allow me to >>>> set up the "official beancount forum"? should we discuss this further? >>>> >>> >>> Adding to the cons:- >>> - one additional venue for Martin in particular (and perhaps others) to >>> check, wasting time >>> - Additional internet ID/password combination, increasing threat surface >>> - decreased visibility of any particular topic since forums are by >>> nature segregated >>> >>> This isn't to vote against the proposal, just putting more context. I >>> believe forums should NOT involve the dev (especially the dev's time), as >>> I've seen how much of a time-suck they can be. >>> >>> A wiki would have most of the pros you list, btw, without requiring dev >>> time investment. >>> >>> -- >>> 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 [email protected]. >>> To view this discussion on the web visit >>> https://groups.google.com/d/msgid/beancount/CAGQ70et_RD%2BsFHDnh4kkvHQLzPmuHGVHwAzYF2qh1vOhm5MsNg%40mail.gmail.com >>> <https://groups.google.com/d/msgid/beancount/CAGQ70et_RD%2BsFHDnh4kkvHQLzPmuHGVHwAzYF2qh1vOhm5MsNg%40mail.gmail.com?utm_medium=email&utm_source=footer> >>> . >>> >> -- > 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 [email protected]. > To view this discussion on the web visit > https://groups.google.com/d/msgid/beancount/e0379f15-642a-424f-81df-7dd87fa314a0n%40googlegroups.com > <https://groups.google.com/d/msgid/beancount/e0379f15-642a-424f-81df-7dd87fa314a0n%40googlegroups.com?utm_medium=email&utm_source=footer> > . > -- 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 [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/beancount/CAK21%2BhPCPpyGcp7Re%2Bogz7_2WAS_VfKoUjZea_oNevC_EibQpA%40mail.gmail.com.
