{"title":"Stabilność API","version":"1.10","locale":"pl","docname":"misc/api-stability","url":"/pl/1.10/misc/api-stability/","canonical":"https://djangodocs.dev/pl/1.10/misc/api-stability/","summary":"Django gwarantuje stabliność i kompatybilność wsteczną API od wersji 1.0. W skrócie, to znaczy, że kod, który pisałeś w jakiejś wersji Django będzie wciąż działał z…","html":"<h1>Stabilność API<a class=\"heading-anchor\" href=\"#api-stability\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>Django gwarantuje stabliność i kompatybilność wsteczną API od wersji 1.0. W skrócie, to znaczy, że kod, który pisałeś w jakiejś wersji Django będzie wciąż działał z przyszłymi wydaniami. Możesz musieć wprowadzić małe zmiany podczas upgrade’owania wersji Django, z której korzysta twój projekt: zobacz sekcje „Zmiany niekompatybilne wstecz” <a class=\"reference internal\" href=\"/pl/1.10/releases/\"><span class=\"doc\">notatek o wydaniach</span></a> dla wersji z której lub wersji z których się upgrade’ujesz.</p>\n<section id=\"what-stable-means\">\n<h2>Co oznacza „stabilny” (ang. stable)<a class=\"heading-anchor\" href=\"#what-stable-means\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>W tym kontekście, stabilny oznacza:</p>\n<ul>\n<li><p>All the public APIs (everything in this documentation) will not be moved\nor renamed without providing backwards-compatible aliases.</p></li>\n<li><p>If new features are added to these APIs – which is quite possible –\nthey will not break or change the meaning of existing methods. In other\nwords, „stable” does not (necessarily) mean „complete.”</p></li>\n<li><p>If, for some reason, an API declared stable must be removed or replaced, it\nwill be declared deprecated but will remain in the API for at least two\nfeature releases. Warnings will be issued when the deprecated method is\ncalled.</p>\n<p>See <a class=\"reference internal\" href=\"/pl/1.10/internals/release-process/#official-releases\"><span class=\"std std-ref\">Official releases</span></a> for more details on how Django’s version\nnumbering scheme works, and how features will be deprecated.</p>\n</li>\n<li><p>We’ll only break backwards compatibility of these APIs if a bug or\nsecurity hole makes it completely unavoidable.</p></li>\n</ul>\n</section>\n<section id=\"stable-apis\">\n<h2>Stable APIs<a class=\"heading-anchor\" href=\"#stable-apis\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>In general, everything covered in the documentation – with the exception of\nanything in the <a class=\"reference internal\" href=\"/pl/1.10/internals/\"><span class=\"doc\">internals area</span></a> is considered stable.</p>\n</section>\n<section id=\"exceptions\">\n<h2>Wyjątki<a class=\"heading-anchor\" href=\"#exceptions\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>There are a few exceptions to this stability and backwards-compatibility\npromise.</p>\n<section id=\"security-fixes\">\n<h3>Poprawki bezpieczeństwa<a class=\"heading-anchor\" href=\"#security-fixes\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>If we become aware of a security problem – hopefully by someone following our\n<a class=\"reference internal\" href=\"/pl/1.10/internals/security/#reporting-security-issues\"><span class=\"std std-ref\">security reporting policy</span></a> – we’ll do\neverything necessary to fix it. This might mean breaking backwards\ncompatibility; security trumps the compatibility guarantee.</p>\n</section>\n<section id=\"apis-marked-as-internal\">\n<h3>APIs marked as internal<a class=\"heading-anchor\" href=\"#apis-marked-as-internal\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>Certain APIs are explicitly marked as „internal” in a couple of ways:</p>\n<ul class=\"simple\">\n<li><p>Some documentation refers to internals and mentions them as such. If the\ndocumentation says that something is internal, we reserve the right to\nchange it.</p></li>\n<li><p>Functions, methods, and other objects prefixed by a leading underscore\n(<code class=\"docutils literal notranslate\"><span class=\"pre\">_</span></code>). This is the standard Python way of indicating that something is\nprivate; if any method starts with a single <code class=\"docutils literal notranslate\"><span class=\"pre\">_</span></code>, it’s an internal API.</p></li>\n</ul>\n</section>\n</section>","rootId":"api-stability","toc":[{"title":"Co oznacza „stabilny” (ang. stable)","anchor":"what-stable-means","children":[]},{"title":"Stable APIs","anchor":"stable-apis","children":[]},{"title":"Wyjątki","anchor":"exceptions","children":[{"title":"Poprawki bezpieczeństwa","anchor":"security-fixes","children":[]},{"title":"APIs marked as internal","anchor":"apis-marked-as-internal","children":[]}]}],"breadcrumbs":[{"docname":"misc/index","title":"Meta-documentation and miscellany","url":"/pl/1.10/misc/"}],"prev":{"docname":"misc/index","title":"Meta-documentation and miscellany","url":"/pl/1.10/misc/"},"next":{"docname":"misc/design-philosophies","title":"Design philosophies","url":"/pl/1.10/misc/design-philosophies/"},"formats":{"html":"/pl/1.10/misc/api-stability/","markdown":"/pl/1.10/misc/api-stability.md","json":"/pl/1.10/misc/api-stability.json"},"source":"https://github.com/django/django/blob/stable/1.10.x/docs/misc/api-stability.txt","official":"https://docs.djangoproject.com/pl/1.10/misc/api-stability/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10"],"inLocales":["en","fr","ja","id","pt-br","es","el","pl"]}