Skip to content

IN-1697 - update Python guidelines updates#62

Open
ghukill wants to merge 2 commits intomainfrom
python-guidelines-updates
Open

IN-1697 - update Python guidelines updates#62
ghukill wants to merge 2 commits intomainfrom
python-guidelines-updates

Conversation

@ghukill
Copy link

@ghukill ghukill commented Mar 24, 2026

Why these changes are being introduced

The python guidelines were remarkably accurate given a fairly lengthy stay
between updates, but some areas were beginning to need some updates.

Additionally, we are currently actively experimenting with a "specification"
of sorts for python projects, a document that is designed to be a bit more
granular than these guidelines.

How this addresses that need:

  • Updates sections where small changes are needed (e.g. pipenv -> uv)
  • Adds new "python projects specification" section that briefly notes
    and links to a specification document with more granular details about
    project conventions

How this addresses that need

See the updated form of the python guidelines rendered here.

Side effects of this change

  • First experimental integration of the dev docs wiki and the new
    python project specification repository

Relevant ticket(s)

ghukill added 2 commits March 5, 2026 11:50
Why these changes are being introduced:

The python guidelines were remarkably accurate given a fairly lengthy stay
between updates, but some areas were beginning to need some updates.

Additionally, we are currently actively experimenting with a "specification"
of sorts for python projects, a document that is designed to be a bit more
granular than these guidelines.

How this addresses that need:
* Updates sections where small changes are needed (e.g. pipenv -> uv)
* Adds new "python projects specification" section that briefly notes
and links to a specification document with more granular details about
project conventions

Side effects of this change:
* First experimental integration of the dev docs wiki and the new
python project specification repository

Relevant ticket(s):
* https://mitlibraries.atlassian.net/browse/IN-1697
@ghukill ghukill marked this pull request as ready for review March 24, 2026 17:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant