On Mon, Aug 14, 2017 at 11:29:30PM -0400, Martin Blais wrote:
> I could whine here about the advocacy on the mailing-list---as you
> already know, I don't care much for it. I'm a pragmatist.
>
> But let me not do that and instead turn your bottomless energy into a
> productive channel:

This is not the first time that I've the feeling you read much more in
my posts than there is to it---the other time was when I was trying to
figure out which precise version of a license Beancount was distributed
under, which was unclear at the time (and you've fixed since, thank
you!).

You mentioned a feature I'm personally interested in: search throughout
the entire Beancount documentation, rather than document by document.
As per your suggestion I've tried to make it work in my specific
condition, and it didn't work for me. Hence my message here, asking to
people more experienced than me in using Google Docs, if I was missing
something or not. It's as simple as that.

If I were "advocating", I would've been way more clear, I'm not a sneaky
person.

> as soon as I find some free time I'll download all the exported
> formats from Google Docs for each of the docs under well organized
> naming and place them somewhere you can access and download them. If
> you can build some way to automatically convert from any combination
> of those into Markdown format that would process and look really nice
> under Sphinx processing, I'll be happy to hook that conversion routine
> into the API calls and make /that/ an official mirror of the
> documentation. After all, there's nothing quite like scratching your
> own itch.
>
> Sounds like a deal?

That would be awesome, yes.

I'm also glad you're treating requests posted here (an inappropriate
venue for that) of an offline/buildable documentation as a proper bug
report, and also kind enough to be willing to spend some of your
volunteer time to fix it. Beancount's is some of the best documentation
I've seen around in the Free Software projects I use daily, and that
technical bit will enable some of us to peruse it even more effectively.
Thank you!

(If you prefer to have this as a proper bug report in the BTS, so that
we can coordinate to implement the needed bits, just let me know.)

Cheers.
-- 
Stefano Zacchiroli . [email protected] . upsilon.cc/zack . . o . . . o . o
Computer Science Professor . CTO Software Heritage . . . . . o . . . o o
Former Debian Project Leader & OSI Board Director  . . . o o o . . . o .
« the first rule of tautology club is the first rule of tautology club »

-- 
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 post to this group, send email to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/beancount/20170815220430.barhwf3746b3yvu7%40upsilon.cc.
For more options, visit https://groups.google.com/d/optout.

Reply via email to