mamedev/docs

Delete this repository or close the "issues" tab, and point users to github.com/mamedev/mame

anewuser opened this issue · 6 comments

The page titles still say "MAME Documentation 0.174", and the "Edit on Github" link still points to this repository.

Two things:

  1. You're in the wrong area to make comments on current MAME /docs. That would actually be the github.com/mamedev/mame tree. What is here in github.com/mamedev/docs is old but preserved for now. (Pretty sure we can delete it now).

  2. Even at the right docs location: https://github.com/mamedev/mame/blob/master/docs/source/conf.py
    it's still set at 0.174. Issue is that our documentation lead @Firehawke has had some significant downtime, and you know MAMEdevs: anyone else is too preoccupied with the emulation to work on the documentation. Point of fact is, I don't know if there's been new options added or modified to MAME since 0.174, and if there has, the docs haven't been updated. So for now, until someone gets the time to verify that, I'm leaving the version number stuck at 0.174 in https://github.com/mamedev/mame/blob/master/docs/source/conf.py

It was the "Edit on Github" link at the top of the page (http://docs.mamedev.org/) that pointed me to this repository.

Apparently, while the readme for the docs repository had been edited in a5524d2 to indicate where /docs/ had gone, the "Edit on Github" links were missed when it was transferred to https://github.com/mamedev/mame. Fixed in mamedev/mame@847e0a1

Will close this issue, then close issues completely via either of the ways you've suggested. Thanks for bringing this to our attention, @anewuser . You're welcome to create a new issue regarding the documentation page titles in github.com/mamedev/mame.

@stilett0 Thank you for the replies. Just one last thing for now: I only mentioned the "Edit on Github" part, but the "issue tracker" and "contribute links in the "Note" box (at the top of the documentation frontpage) actually point to this place too.

While this is closed, I just want to clarify that apparently there have been some significant additions to the command-line options since the docs were last updated. Work is in progress to try to get that at least somewhat reconciled.