pytorch / pytorch/pytorch.github.io

Contributing guide missing

Open
#501 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
HTML
Stars
285
Forks
317
PR merge metrics
No merged PRs in 30d

Description

Neither template fitted this issue:

I came to this repository in the hope of updating the documentation for a particular module's function.

I can't see a contributing guide in this repository for updating the documentation served from pytorch.org.

It took me quite a while to realise that the .html files in this repo seem to be generated from the docstrings in the pytorch repo.

How about a contributing.md pointing to the pytorch repo for code documention updates?

Also, perhaps document the structure of this repository Eg:

  • docs/master is the next release
  • docs/release is the current release

It seems that make serve serves from release. How to serve from master?

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by inspecting docs/master, docs/release, the existing make serve entry point, and how the site is generated from PyTorch docstrings. Done means a contributing.md explains where documentation updates belong, documents the repository structure and release directories, and answers how to serve master instead of release.

Written by the indexing model from the issue text.

Assessment

Tech stack
html, markdown
Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.