Documentation/filesystems/xfs/xfs-maintainer-entry-profile.rst

Source file repositories/reference/linux-study-clean/Documentation/filesystems/xfs/xfs-maintainer-entry-profile.rst

File Facts

System
Linux kernel
Corpus path
Documentation/filesystems/xfs/xfs-maintainer-entry-profile.rst
Extension
.rst
Size
7761 bytes
Lines
195
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: documentation
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

XFS Maintainer Entry Profile
============================

Overview
--------
XFS is a well known high-performance filesystem in the Linux kernel.
The aim of this project is to provide and maintain a robust and
performant filesystem.

Patches are generally merged to the for-next branch of the appropriate
git repository.
After a testing period, the for-next branch is merged to the master
branch.

Kernel code are merged to the xfs-linux tree[0].
Userspace code are merged to the xfsprogs tree[1].
Test cases are merged to the xfstests tree[2].
Ondisk format documentation are merged to the xfs-documentation tree[3].

All patchsets involving XFS *must* be cc'd in their entirety to the mailing
list linux-xfs@vger.kernel.org.

Roles
-----
There are eight key roles in the XFS project.
A person can take on multiple roles, and a role can be filled by
multiple people.
Anyone taking on a role is advised to check in with themselves and
others on a regular basis about burnout.

- **Outside Contributor**: Anyone who sends a patch but is not involved
  in the XFS project on a regular basis.
  These folks are usually people who work on other filesystems or
  elsewhere in the kernel community.

- **Developer**: Someone who is familiar with the XFS codebase enough to
  write new code, documentation, and tests.

  Developers can often be found in the IRC channel mentioned by the ``C:``
  entry in the kernel MAINTAINERS file.

- **Senior Developer**: A developer who is very familiar with at least
  some part of the XFS codebase and/or other subsystems in the kernel.
  These people collectively decide the long term goals of the project
  and nudge the community in that direction.
  They should help prioritize development and review work for each release
  cycle.

  Senior developers tend to be more active participants in the IRC channel.

- **Reviewer**: Someone (most likely also a developer) who reads code
  submissions to decide:

  0. Is the idea behind the contribution sound?
  1. Does the idea fit the goals of the project?
  2. Is the contribution designed correctly?
  3. Is the contribution polished?
  4. Can the contribution be tested effectively?

  Reviewers should identify themselves with an ``R:`` entry in the kernel
  and fstests MAINTAINERS files.

- **Testing Lead**: This person is responsible for setting the test
  coverage goals of the project, negotiating with developers to decide
  on new tests for new features, and making sure that developers and
  release managers execute on the testing.

  The testing lead should identify themselves with an ``M:`` entry in
  the XFS section of the fstests MAINTAINERS file.

Annotation

Implementation Notes