You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{"payload":{"allShortcutsEnabled":false,"fileTree":{"":{"items":[{"name":"conf","path":"conf","contentType":"directory"},{"name":"debian","path":"debian","contentType":"directory"},{"name":"doc","path":"doc","contentType":"directory"},{"name":"pkg","path":"pkg","contentType":"directory"},{"name":"salt","path":"salt","contentType":"directory"},{"name":"scripts","path":"scripts","contentType":"directory"},{"name":"tests","path":"tests","contentType":"directory"},{"name":".gitignore","path":".gitignore","contentType":"file"},{"name":".pylintrc","path":".pylintrc","contentType":"file"},{"name":".travis.yml","path":".travis.yml","contentType":"file"},{"name":"AUTHORS","path":"AUTHORS","contentType":"file"},{"name":"Contributing.rst","path":"Contributing.rst","contentType":"file"},{"name":"HACKING.rst","path":"HACKING.rst","contentType":"file"},{"name":"LICENSE","path":"LICENSE","contentType":"file"},{"name":"MANIFEST.in","path":"MANIFEST.in","contentType":"file"},{"name":"README.rst","path":"README.rst","contentType":"file"},{"name":"dev_requirements.txt","path":"dev_requirements.txt","contentType":"file"},{"name":"requirements.txt","path":"requirements.txt","contentType":"file"},{"name":"setup.py","path":"setup.py","contentType":"file"},{"name":"tox.ini","path":"tox.ini","contentType":"file"}],"totalCount":20}},"fileTreeProcessingTime":8.826205,"foldersToFetch":[],"incompleteFileTree":false,"repo":{"id":8149657,"defaultBranch":"develop","name":"salt","ownerLogin":"rca","currentUserCanPush":false,"isFork":true,"isEmpty":false,"createdAt":"2013-02-11T23:56:16.000Z","ownerAvatar":"https://avatars.githubusercontent.com/u/53537?v=4","public":true,"private":false,"isOrgOwned":false},"codeLineWrapEnabled":false,"symbolsExpanded":false,"treeExpanded":true,"refInfo":{"name":"develop","listCacheKey":"v0:1384365293.0","canEdit":false,"refType":"branch","currentOid":"dc2f0f3c1928b5ba9197355798a01e923c12f529"},"path":"Contributing.rst","currentUser":null,"blob":{"rawLines":null,"stylingDirectives":null,"colorizedLines":null,"csv":null,"csvError":null,"dependabotInfo":{"showConfigurationBanner":false,"configFilePath":null,"networkDependabotPath":"/rca/salt/network/updates","dismissConfigurationNoticePath":"/settings/dismiss-notice/dependabot_configuration_notice","configurationNoticeDismissed":null},"displayName":"Contributing.rst","displayUrl":"https://github.com/rca/salt/blob/develop/Contributing.rst?raw=true","headerInfo":{"blobSize":"2.95 KB","deleteTooltip":"You must be signed in to make or propose changes","editTooltip":"You must be signed in to make or propose changes","ghDesktopPath":"https://desktop.github.com","isGitLfs":false,"onBranch":true,"shortPath":"ace920c","siteNavLoginPath":"/login?return_to=https%3A%2F%2Fgithub.com%2Frca%2Fsalt%2Fblob%2Fdevelop%2FContributing.rst","isCSV":false,"isRichtext":true,"toc":[{"level":2,"text":"Reporting issues","anchor":"reporting-issues","htmlText":"Reporting issues"},{"level":3,"text":"Bugs","anchor":"bugs","htmlText":"Bugs"},{"level":3,"text":"Features","anchor":"features","htmlText":"Features"},{"level":2,"text":"Fixing issues","anchor":"fixing-issues","htmlText":"Fixing issues"}],"lineInfo":{"truncatedLoc":"73","truncatedSloc":"51"},"mode":"file"},"image":false,"isCodeownersFile":null,"isPlain":false,"isValidLegacyIssueTemplate":false,"issueTemplate":null,"discussionTemplate":null,"language":"reStructuredText","languageID":419,"large":false,"planSupportInfo":{"repoIsFork":null,"repoOwnedByCurrentUser":null,"requestFullPath":"/rca/salt/blob/develop/Contributing.rst","showFreeOrgGatedFeatureMessage":null,"showPlanSupportBanner":null,"upgradeDataAttributes":null,"upgradePath":null},"publishBannersInfo":{"dismissActionNoticePath":"/settings/dismiss-notice/publish_action_from_dockerfile","releasePath":"/rca/salt/releases/new?marketplace=true","showPublishActionBanner":false},"rawBlobUrl":"https://github.com/rca/salt/raw/refs/heads/develop/Contributing.rst","renderImageOrRaw":false,"richText":"\u003carticle class=\"markdown-body entry-content container-lg\" itemprop=\"text\"\u003e\u003ca name=\"user-content-reporting-issues\"\u003e\u003c/a\u003e\n\u003cdiv class=\"markdown-heading\" dir=\"auto\"\u003e\u003ch2 tabindex=\"-1\" class=\"heading-element\" dir=\"auto\"\u003eReporting issues\u003c/h2\u003e\u003ca id=\"user-content-reporting-issues\" class=\"anchor\" aria-label=\"Permalink: Reporting issues\" href=\"#reporting-issues\"\u003e\u003csvg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"\u003e\u003cpath d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"\u003e\u003c/path\u003e\u003c/svg\u003e\u003c/a\u003e\u003c/div\u003e\n\u003cp dir=\"auto\"\u003eThe Salt issue tracker is used for feature requests and bug reports.\u003c/p\u003e\n\u003ca name=\"user-content-bugs\"\u003e\u003c/a\u003e\n\u003cdiv class=\"markdown-heading\" dir=\"auto\"\u003e\u003ch3 tabindex=\"-1\" class=\"heading-element\" dir=\"auto\"\u003eBugs\u003c/h3\u003e\u003ca id=\"user-content-bugs\" class=\"anchor\" aria-label=\"Permalink: Bugs\" href=\"#bugs\"\u003e\u003csvg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"\u003e\u003cpath d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"\u003e\u003c/path\u003e\u003c/svg\u003e\u003c/a\u003e\u003c/div\u003e\n\u003cp dir=\"auto\"\u003eA bug is a \u003cem\u003edemonstrable problem\u003c/em\u003e that is caused by the code in the repository.\u003c/p\u003e\n\u003cp dir=\"auto\"\u003ePlease read the following guidelines before you \u003ca href=\"https://github.com/saltstack/salt/issues\"\u003ereport an issue\u003c/a\u003e\u003c/p\u003e\n\u003col dir=\"auto\"\u003e\n\u003cli\u003e\u003cstrong\u003eUse the GitHub issue search\u003c/strong\u003e — check if the issue has\nalready been reported. If it has been, please comment on the existing issue.\u003c/li\u003e\n\u003cli\u003e\u003cstrong\u003eCheck if the issue has been fixed\u003c/strong\u003e — the latest develop\nbranch may already contain a fix. Please try to reproduce the bug against\nthe latest git head or the latest release.\u003c/li\u003e\n\u003cli\u003e\u003cstrong\u003eIsolate the demonstrable problem\u003c/strong\u003e — make sure that the\ncode in the project's repository is \u003cem\u003edefinitely\u003c/em\u003e responsible for the issue.\u003c/li\u003e\n\u003cli\u003e\u003cstrong\u003eInclude a reproducible example\u003c/strong\u003e — Provide the steps which\nled you to the problem.\u003c/li\u003e\n\u003c/ol\u003e\n\u003cp dir=\"auto\"\u003ePlease try to be as detailed as possible in your report too. What is your\nenvironment? What steps will reproduce the issue? What Operating System? What\nwould you expect to be the outcome? All these details will help people to\nassess and fix any potential bugs.\u003c/p\u003e\n\u003cp dir=\"auto\"\u003e\u003cstrong\u003eIncluding the output of\u003c/strong\u003e \u003ccode\u003esalt --versions-report\u003c/code\u003e \u003cstrong\u003ewill always help.\u003c/strong\u003e\u003c/p\u003e\n\u003cp dir=\"auto\"\u003eValid bugs will be categorized for the next release and worked on as quickly\nas resources can be reasonably allocated\u003c/p\u003e\n\u003ca name=\"user-content-features\"\u003e\u003c/a\u003e\n\u003cdiv class=\"markdown-heading\" dir=\"auto\"\u003e\u003ch3 tabindex=\"-1\" class=\"heading-element\" dir=\"auto\"\u003eFeatures\u003c/h3\u003e\u003ca id=\"user-content-features\" class=\"anchor\" aria-label=\"Permalink: Features\" href=\"#features\"\u003e\u003csvg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"\u003e\u003cpath d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"\u003e\u003c/path\u003e\u003c/svg\u003e\u003c/a\u003e\u003c/div\u003e\n\u003cp dir=\"auto\"\u003eSalt is always working to be more powerful. Feature additions and requests are\nwelcomed. When requesting a feature it will be categorized for a release or\nplaced under \"Approved for Future Release\".\u003c/p\u003e\n\u003cp dir=\"auto\"\u003eIf a new feature is desired, the fastest way to get it into Salt is to\ncontribute the code. Before starting on a new feature an issue should be filed\nfor it. The one requesting the feature will be able to then discuss the feature\nwith the Salt team and discover the best way to get the feature into Salt and\nif the feature makes sense.\u003c/p\u003e\n\u003cp dir=\"auto\"\u003eIt is extremely common that the desired feature has already been completed,\nlook for it in the docs, ask about it first in IRC, and on the mailing list\nbefore filing the request. It is also common that the problem which would be\nsolved by the new feature can be easily solved another way, which is a great\nreason to ask first.\u003c/p\u003e\n\u003ca name=\"user-content-fixing-issues\"\u003e\u003c/a\u003e\n\u003cdiv class=\"markdown-heading\" dir=\"auto\"\u003e\u003ch2 tabindex=\"-1\" class=\"heading-element\" dir=\"auto\"\u003eFixing issues\u003c/h2\u003e\u003ca id=\"user-content-fixing-issues\" class=\"anchor\" aria-label=\"Permalink: Fixing issues\" href=\"#fixing-issues\"\u003e\u003csvg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"\u003e\u003cpath d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"\u003e\u003c/path\u003e\u003c/svg\u003e\u003c/a\u003e\u003c/div\u003e\n\u003cp dir=\"auto\"\u003eIf you wish to help us fixing the issue you're reporting, \u003ca href=\"http://docs.saltstack.org/en/latest/index.html\" rel=\"nofollow\"\u003eSalt's documentation\u003c/a\u003e already includes\ninformation to help you setup a development environment, under \u003ca href=\"http://docs.saltstack.org/en/latest/topics/community.html#developing-salt\" rel=\"nofollow\"\u003eDeveloping Salt\u003c/a\u003e.\u003c/p\u003e\n\u003cp dir=\"auto\"\u003eFix the issue you have in hands, if possible also add a test case to Salt's testing suite, create a\n\u003ca href=\"http://docs.saltstack.org/en/latest/topics/community.html#sending-a-github-pull-request\" rel=\"nofollow\"\u003epull request\u003c/a\u003e, and \u003cstrong\u003ethat's it\u003c/strong\u003e!\u003c/p\u003e\n\u003cp dir=\"auto\"\u003eSalt's development team will review your fix and if everything is OK, your fix will be merged into\nsalt's code.\u003c/p\u003e\n\n\u003c/article\u003e","renderedFileInfo":null,"shortPath":null,"symbolsEnabled":true,"tabSize":8,"topBannersInfo":{"overridingGlobalFundingFile":false,"globalPreferredFundingPath":null,"showInvalidCitationWarning":false,"citationHelpUrl":"https://docs.github.com/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/about-citation-files","actionsOnboardingTip":null},"truncated":false,"viewable":true,"workflowRedirectUrl":null,"symbols":{"timed_out":false,"not_analyzed":true,"symbols":[]}},"copilotInfo":null,"copilotAccessAllowed":false,"modelsAccessAllowed":false,"modelsRepoIntegrationEnabled":false,"csrf_tokens":{"/rca/salt/branches":{"post":"zA_vsoRIrcXCVaNn3mHRGQZ5dM4nWMHwhmUInyU__YqKE5LVBD6f3vIYBYr6cATqwzbW8aIc3C5vGOgdlMQ3_Q"},"/repos/preferences":{"post":"c5E3Iv7EwPoNbgqfNs1_0y7Z9Kc9K8WaarZFfVfI4jK3Fb6x1rwsV_ybX8fups5iA4KdasqtyNPbbmMOFB1uEA"}}},"title":"salt/Contributing.rst at develop · rca/salt","appPayload":{"helpUrl":"https://docs.github.com","findFileWorkerPath":"/assets-cdn/worker/find-file-worker-7d7eb7c71814.js","findInFileWorkerPath":"/assets-cdn/worker/find-in-file-worker-1ae9fa256942.js","githubDevUrl":null,"enabled_features":{"code_nav_ui_events":false,"react_blob_overlay":false,"accessible_code_button":true,"github_models_repo_integration":false}}}