€•iJŒsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œ translations”Œ LanguagesNode”“”)”}”(hhh]”(hŒ pending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ refdomain”Œstd”Œreftype”Œdoc”Œ reftarget”Œ7/translations/zh_CN/maintainer/maintainer-entry-profile”Œmodname”NŒ classname”NŒ refexplicit”ˆuŒtagname”hhh ubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ7/translations/zh_TW/maintainer/maintainer-entry-profile”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ7/translations/it_IT/maintainer/maintainer-entry-profile”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ7/translations/ja_JP/maintainer/maintainer-entry-profile”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ7/translations/ko_KR/maintainer/maintainer-entry-profile”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ7/translations/pt_BR/maintainer/maintainer-entry-profile”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ7/translations/sp_SP/maintainer/maintainer-entry-profile”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h hhŒ _document”hŒsource”NŒline”NubhŒtarget”“”)”}”(hŒ.. _maintainerentryprofile:”h]”h}”(h]”h ]”h"]”h$]”h&]”Œrefid”Œmaintainerentryprofile”uh1hµh´Khhh²hh³ŒQ/var/lib/git/docbuild/linux/Documentation/maintainer/maintainer-entry-profile.rst”ubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒMaintainer Entry Profile”h]”hŒMaintainer Entry Profile”…””}”(hhËh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhhÆh²hh³hÃh´KubhŒ paragraph”“”)”}”(hX¥The Maintainer Entry Profile supplements the top-level process documents (submitting-patches, submitting drivers...) with subsystem/device-driver-local customs as well as details about the patch submission life-cycle. A contributor uses this document to level set their expectations and avoid common mistakes; maintainers may use these profiles to look across subsystems for opportunities to converge on common practices.”h]”hX¥The Maintainer Entry Profile supplements the top-level process documents (submitting-patches, submitting drivers...) with subsystem/device-driver-local customs as well as details about the patch submission life-cycle. A contributor uses this document to level set their expectations and avoid common mistakes; maintainers may use these profiles to look across subsystems for opportunities to converge on common practices.”…””}”(hhÛh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´KhhÆh²hubhÅ)”}”(hhh]”(hÊ)”}”(hŒOverview”h]”hŒOverview”…””}”(hhìh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhhéh²hh³hÃh´KubhÚ)”}”(hŒâProvide an introduction to how the subsystem operates. While MAINTAINERS tells the contributor where to send patches for which files, it does not convey other subsystem-local infrastructure and mechanisms that aid development.”h]”hŒâProvide an introduction to how the subsystem operates. While MAINTAINERS tells the contributor where to send patches for which files, it does not convey other subsystem-local infrastructure and mechanisms that aid development.”…””}”(hhúh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´Khhéh²hubhÚ)”}”(hŒExample questions to consider:”h]”hŒExample questions to consider:”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´Khhéh²hubhŒ bullet_list”“”)”}”(hhh]”(hŒ list_item”“”)”}”(hŒWAre there notifications when patches are applied to the local tree, or merged upstream?”h]”hÚ)”}”(hŒWAre there notifications when patches are applied to the local tree, or merged upstream?”h]”hŒWAre there notifications when patches are applied to the local tree, or merged upstream?”…””}”(hj!h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´Khjubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjh²hh³hÃh´Nubj)”}”(hŒSDoes the subsystem have a patchwork instance? Are patchwork state changes notified?”h]”hÚ)”}”(hŒSDoes the subsystem have a patchwork instance? Are patchwork state changes notified?”h]”hŒSDoes the subsystem have a patchwork instance? Are patchwork state changes notified?”…””}”(hj9h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´Khj5ubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjh²hh³hÃh´Nubj)”}”(hŒ~Any bots or CI infrastructure that watches the list, or automated testing feedback that the subsystem uses to gate acceptance?”h]”hÚ)”}”(hŒ~Any bots or CI infrastructure that watches the list, or automated testing feedback that the subsystem uses to gate acceptance?”h]”hŒ~Any bots or CI infrastructure that watches the list, or automated testing feedback that the subsystem uses to gate acceptance?”…””}”(hjQh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´KhjMubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjh²hh³hÃh´Nubj)”}”(hŒ(Git branches that are pulled into -next?”h]”hÚ)”}”(hjgh]”hŒ(Git branches that are pulled into -next?”…””}”(hjih²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´Khjeubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjh²hh³hÃh´Nubj)”}”(hŒ/What branch should contributors submit against?”h]”hÚ)”}”(hj~h]”hŒ/What branch should contributors submit against?”…””}”(hj€h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´Khj|ubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjh²hh³hÃh´Nubj)”}”(hŒðLinks to any other Maintainer Entry Profiles? For example a device-driver may point to an entry for its parent subsystem. This makes the contributor aware of obligations a maintainer may have for other maintainers in the submission chain. ”h]”hÚ)”}”(hŒîLinks to any other Maintainer Entry Profiles? For example a device-driver may point to an entry for its parent subsystem. This makes the contributor aware of obligations a maintainer may have for other maintainers in the submission chain.”h]”hŒîLinks to any other Maintainer Entry Profiles? For example a device-driver may point to an entry for its parent subsystem. This makes the contributor aware of obligations a maintainer may have for other maintainers in the submission chain.”…””}”(hj—h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´K hj“ubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjh²hh³hÃh´Nubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1jh³hÃh´Khhéh²hubeh}”(h]”Œoverview”ah ]”h"]”Œoverview”ah$]”h&]”uh1hÄhhÆh²hh³hÃh´KubhÅ)”}”(hhh]”(hÊ)”}”(hŒSubmit Checklist Addendum”h]”hŒSubmit Checklist Addendum”…””}”(hj¾h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhj»h²hh³hÃh´K'ubhÚ)”}”(hŒôList mandatory and advisory criteria, beyond the common "submit-checklist", for a patch to be considered healthy enough for maintainer attention. For example: "pass checkpatch.pl with no errors, or warning. Pass the unit test detailed at $URI".”h]”hŒüList mandatory and advisory criteria, beyond the common “submit-checklistâ€, for a patch to be considered healthy enough for maintainer attention. For example: “pass checkpatch.pl with no errors, or warning. Pass the unit test detailed at $URIâ€.”…””}”(hjÌh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´K(hj»h²hubhÚ)”}”(hŒåThe Submit Checklist Addendum can also include details about the status of related hardware specifications. For example, does the subsystem require published specifications at a certain revision before patches will be considered.”h]”hŒåThe Submit Checklist Addendum can also include details about the status of related hardware specifications. For example, does the subsystem require published specifications at a certain revision before patches will be considered.”…””}”(hjÚh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´K-hj»h²hubeh}”(h]”Œsubmit-checklist-addendum”ah ]”h"]”Œsubmit checklist addendum”ah$]”h&]”uh1hÄhhÆh²hh³hÃh´K'ubhÅ)”}”(hhh]”(hÊ)”}”(hŒKey Cycle Dates”h]”hŒKey Cycle Dates”…””}”(hjóh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhjðh²hh³hÃh´K4ubhÚ)”}”(hXÎOne of the common misunderstandings of submitters is that patches can be sent at any time before the merge window closes and can still be considered for the next -rc1. The reality is that most patches need to be settled in soaking in linux-next in advance of the merge window opening. Clarify for the submitter the key dates (in terms of -rc release week) that patches might be considered for merging and when patches need to wait for the next -rc. At a minimum:”h]”hXÎOne of the common misunderstandings of submitters is that patches can be sent at any time before the merge window closes and can still be considered for the next -rc1. The reality is that most patches need to be settled in soaking in linux-next in advance of the merge window opening. Clarify for the submitter the key dates (in terms of -rc release week) that patches might be considered for merging and when patches need to wait for the next -rc. At a minimum:”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´K5hjðh²hubj)”}”(hhh]”(j)”}”(hXêLast -rc for new feature submissions: New feature submissions targeting the next merge window should have their first posting for consideration before this point. Patches that are submitted after this point should be clear that they are targeting the NEXT+1 merge window, or should come with sufficient justification why they should be considered on an expedited schedule. A general guideline is to set expectation with contributors that new feature submissions should appear before -rc5. ”h]”(hÚ)”}”(hŒ%Last -rc for new feature submissions:”h]”hŒ%Last -rc for new feature submissions:”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´K=hjubhÚ)”}”(hXÂNew feature submissions targeting the next merge window should have their first posting for consideration before this point. Patches that are submitted after this point should be clear that they are targeting the NEXT+1 merge window, or should come with sufficient justification why they should be considered on an expedited schedule. A general guideline is to set expectation with contributors that new feature submissions should appear before -rc5.”h]”hXÂNew feature submissions targeting the next merge window should have their first posting for consideration before this point. Patches that are submitted after this point should be clear that they are targeting the NEXT+1 merge window, or should come with sufficient justification why they should be considered on an expedited schedule. A general guideline is to set expectation with contributors that new feature submissions should appear before -rc5.”…””}”(hj$h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´K?hjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jhjh²hh³hÃh´Nubj)”}”(hX†Last -rc to merge features: Deadline for merge decisions Indicate to contributors the point at which an as yet un-applied patch set will need to wait for the NEXT+1 merge window. Of course there is no obligation to ever accept any given patchset, but if the review has not concluded by this point the expectation is the contributor should wait and resubmit for the following merge window. ”h]”(hÚ)”}”(hŒ8Last -rc to merge features: Deadline for merge decisions”h]”hŒ8Last -rc to merge features: Deadline for merge decisions”…””}”(hj<h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´KGhj8ubhÚ)”}”(hXKIndicate to contributors the point at which an as yet un-applied patch set will need to wait for the NEXT+1 merge window. Of course there is no obligation to ever accept any given patchset, but if the review has not concluded by this point the expectation is the contributor should wait and resubmit for the following merge window.”h]”hXKIndicate to contributors the point at which an as yet un-applied patch set will need to wait for the NEXT+1 merge window. Of course there is no obligation to ever accept any given patchset, but if the review has not concluded by this point the expectation is the contributor should wait and resubmit for the following merge window.”…””}”(hjJh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´KIhj8ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jhjh²hh³hÃh´Nubeh}”(h]”h ]”h"]”h$]”h&]”j±j²uh1jh³hÃh´K=hjðh²hubhÚ)”}”(hŒ Optional:”h]”hŒ Optional:”…””}”(hjdh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´KOhjðh²hubj)”}”(hhh]”j)”}”(hŒ…First -rc at which the development baseline branch, listed in the overview section, should be considered ready for new submissions. ”h]”hÚ)”}”(hŒƒFirst -rc at which the development baseline branch, listed in the overview section, should be considered ready for new submissions.”h]”hŒƒFirst -rc at which the development baseline branch, listed in the overview section, should be considered ready for new submissions.”…””}”(hjyh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´KQhjuubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjrh²hh³hÃh´Nubah}”(h]”h ]”h"]”h$]”h&]”j±j²uh1jh³hÃh´KQhjðh²hubeh}”(h]”Œkey-cycle-dates”ah ]”h"]”Œkey cycle dates”ah$]”h&]”uh1hÄhhÆh²hh³hÃh´K4ubhÅ)”}”(hhh]”(hÊ)”}”(hŒReview Cadence”h]”hŒReview Cadence”…””}”(hjžh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhj›h²hh³hÃh´KVubhÚ)”}”(hXÊOne of the largest sources of contributor angst is how soon to ping after a patchset has been posted without receiving any feedback. In addition to specifying how long to wait before a resubmission this section can also indicate a preferred style of update like, resend the full series, or privately send a reminder email. This section might also list how review works for this code area and methods to get feedback that are not directly from the maintainer.”h]”hXÊOne of the largest sources of contributor angst is how soon to ping after a patchset has been posted without receiving any feedback. In addition to specifying how long to wait before a resubmission this section can also indicate a preferred style of update like, resend the full series, or privately send a reminder email. This section might also list how review works for this code area and methods to get feedback that are not directly from the maintainer.”…””}”(hj¬h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´KWhj›h²hubeh}”(h]”Œreview-cadence”ah ]”h"]”Œreview cadence”ah$]”h&]”uh1hÄhhÆh²hh³hÃh´KVubhÅ)”}”(hhh]”(hÊ)”}”(hŒExisting profiles”h]”hŒExisting profiles”…””}”(hjÅh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhjÂh²hh³hÃh´K`ubhÚ)”}”(hŒxFor now, existing maintainer profiles are listed here; we will likely want to do something different in the near future.”h]”hŒxFor now, existing maintainer profiles are listed here; we will likely want to do something different in the near future.”…””}”(hjÓh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´KbhjÂh²hubhŒcompound”“”)”}”(hhh]”hŒtoctree”“”)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”hŒ#maintainer/maintainer-entry-profile”Œentries”]”(NŒdoc-guide/maintainer-profile”†”NŒnvdimm/maintainer-entry-profile”†”NŒarch/riscv/patch-acceptance”†”NŒprocess/maintainer-soc”†”NŒ process/maintainer-soc-clean-dts”†”NŒ)driver-api/media/maintainer-entry-profile”†”NŒprocess/maintainer-netdev”†”NŒ5driver-api/vfio-pci-device-specific-driver-acceptance”†”NŒnvme/feature-and-quirk-policy”†”NŒ-filesystems/nfs/nfsd-maintainer-entry-profile”†”NŒ,filesystems/xfs/xfs-maintainer-entry-profile”†”NŒmm/damon/maintainer-profile”†”eŒ includefiles”]”(jôjöjøjújüjþjjjjjj eŒmaxdepth”KŒcaption”NŒglob”‰Œhidden”‰Œ includehidden”‰Œnumbered”KŒ titlesonly”‰Œ rawentries”]”uh1jæh³hÃh´Kehjãubah}”(h]”h ]”Œtoctree-wrapper”ah"]”h$]”h&]”uh1jáhjÂh²hh³hÃh´Nubeh}”(h]”Œexisting-profiles”ah ]”h"]”Œexisting profiles”ah$]”h&]”uh1hÄhhÆh²hh³hÃh´K`ubeh}”(h]”(Œmaintainer-entry-profile”hÂeh ]”h"]”(Œmaintainer entry profile”Œmaintainerentryprofile”eh$]”h&]”uh1hÄhhh²hh³hÃh´KŒexpect_referenced_by_name”}”j,h·sŒexpect_referenced_by_id”}”hÂh·subeh}”(h]”h ]”h"]”h$]”h&]”Œsource”hÃuh1hŒcurrent_source”NŒ current_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(hÉNŒ generator”NŒ datestamp”NŒ source_link”NŒ source_url”NŒ toc_backlinks”Œentry”Œfootnote_backlinks”KŒ sectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒ strip_classes”NŒ report_level”KŒ halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ traceback”ˆŒinput_encoding”Œ utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”jVŒerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œ language_code”Œen”Œrecord_dependencies”NŒconfig”NŒ id_prefix”hŒauto_id_prefix”Œid”Œ dump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”hÃŒ _destination”NŒ _config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒ raw_enabled”KŒline_length_limit”M'Œpep_references”NŒ pep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒ rfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œ smart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œ docinfo_xform”KŒsectsubtitle_xform”‰Œ image_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”hÂ]”h·asŒnameids”}”(j,hÂj+j(j¸jµjíjêj˜j•j¿j¼j#j uŒ nametypes”}”(j,ˆj+‰j¸‰jí‰j˜‰j¿‰j#‰uh}”(hÂhÆj(hÆjµhéjêj»j•jðj¼j›j jÂuŒ footnote_refs”}”Œ citation_refs”}”Œ autofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ footnotes”]”Œ citations”]”Œautofootnote_start”KŒsymbol_footnote_start”KŒ id_counter”Œ collections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”hŒsystem_message”“”)”}”(hhh]”hÚ)”}”(hhh]”hŒ