v3 installation, testing, docs

[Eric Altendorf]

https://github.com/beancount/beancount?tab=readme-ov-file

still says v3 is unstable and kinda suggests using v2 as the "current" stable version.  I recommend making it clearer that v3 is the default current version to use now, and remarking that some 3rd party systems (e.g. fava) may require use of the old otherwise deprecated v2.

That page also links to this document for installation instructions:

http://furius.ca/beancount/doc/install

but this is also for v2.  Is there a v3?

It also links to this as canonical documentation:

https://beancount.github.io/docs/

which also has these installation instructions, which reference v2:

https://beancount.github.io/docs/installing_beancount.html

One comment is that I think these are confusing for new users (it was certainly confusing to me when I first arrived here whether v2 or v3 was recommended, and I frequently found myself accidentally referencing docs for the wrong version)

Second is a question, for me specifically right now I'd like to revisit my cost-basis PR, which means I'd like to get beancount set up in dev mode where I can make changes and run the test suite.  What's the right way to do this?

[Eric Altendorf]

Oh, I forgot, I think I mentioned this before, but the v2 install doc:

https://beancount.github.io/docs/installing_beancount.html

links to a supposed v3 install doc at this url:

https://beancount.github.io/docs/installing_beancount_v3.md

however that's a 404.

[Martin Blais]

Thanks for pointing out doc updates need Eric, I'll fix those when I can find some time.

--
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 view this discussion on the web visit https://groups.google.com/d/msgid/beancount/CAFXPr0u5LET3DUMyTntrZ3XX2oc7PMRAZ5tzUipOzJS-4K33Tw%40mail.gmail.com.