https://github.com/chrisjsewell/docutils

A migration of docutils
https://github.com/chrisjsewell/docutils

docutils

Last synced: 8 months ago
JSON representation

A migration of docutils

• Host: GitHub
• URL: https://github.com/chrisjsewell/docutils
• Owner: chrisjsewell
• Created: 2020-08-08T10:00:52.000Z (over 5 years ago)
• Default Branch: develop
• Last Pushed: 2020-08-09T20:32:58.000Z (over 5 years ago)
• Last Synced: 2025-04-15T16:58:04.224Z (10 months ago)
• Topics: docutils
• Language: Python
• Homepage:
• Size: 21.3 MB
• Stars: 10
• Watchers: 6
• Forks: 1
• Open Issues: 112
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# docutils migration

[![codecov](https://codecov.io/gh/chrisjsewell/docutils/branch/develop/graph/badge.svg)](https://codecov.io/gh/chrisjsewell/docutils)

This package is a migration of docutils from  to GitHub.

It originates as a response to discussion in:

- https://sourceforge.net/p/docutils/feature-requests/58/

- https://sourceforge.net/p/docutils/mailman/message/37077728/

- https://github.com/sphinx-doc/sphinx/issues/8039

One of the reasons that appeared to come up is that it is too difficult and/or time consuming to migrate.

This package therefore shows how this can be done in a very simple, autonomous manner:

- migrating code, commit history (with authors) and branches using the [GitHub Importer](https://docs.github.com/en/github/importing-your-projects-to-github/about-github-importer) (this takes about 10 minutes),

- migrating tickets to issues using a python script that interfaces with the SourceForge and GitHub REST APIs (this is both autonomous and idempotent and takes about 10 minutes).

The `main` branch derives from the svn trunk, then here on the `develop` branch this README has been added and a GitHub workflow for Continuous Integration.

Note, two other migrations exist:

- https://github.com/docutils/docutils and https://github.com/docutils-mirror/docutils: these migrations are both from 2015 and do not include branches or ticket migration.

- https://github.com/live-clones/docutils/tree/master/docutils: this is a continually updated clone, but does not include branches, links to commit authors, or the ticket migration.