Max Jones

Hi @djhoese, sorry that this issue went without a response for so long! Documentation improvements are always appreciated - if you still think this would save time you are welcome...

As an explanation for these failures, https://github.com/GenericMappingTools/pygmt/pull/1859 set the canonical url to point to the latest version. For any pages added since the last release, the link checker will fail...

> Another solution is to have a "dynamic" `htmt_baseurl` based on the PyGMT version, similar to what we're doing at > > https://github.com/GenericMappingTools/pygmt/blob/211e03fc79932517b2ca22a562bbaabaa7bc54d1/doc/conf.py#L138-L141 > > ```python > if len(__version__.split("+")) >...

I like the look as well but am hesitant to rely on an experimental extension that would require a fair amount of work to drop.

> > A downside here is that make install no longer works without internet access, even if setuptools>=64 is installed in the environment. > It's unrelated to this PR. Offline...

Yes, I was talking about the first one. https://github.com/GenericMappingTools/pygmt/issues/2097#issuecomment-1231709317 makes sense as an explanation, as I had setuptools installed in my environment.

I can't remember if this has come up in PyGMT spaces before, but the [documentation system](https://documentation.divio.com/) by Daniele Procinda has been mentioned during GMT documentation discussions. For the GMT documentation,...

Also, I agree with this will be a helpful addition that will give new users a place to start, especially people who prefer to learn by reading rather than listening/watching...

Thanks @weiji14 for compiling that information! The plan to start with the methods with many baseline images sounds good to me. I don't think we'll need to do the methods...

I think it's best to try to fix the root of the problem, which is that we are not using dvc in an optimal way.