From Fedora Project Wiki
(Cut out all stuff that doesn't seem relevant)
(Add release notes section to the template.)
 
(3 intermediate revisions by the same user not shown)
Line 18: Line 18:
Specific people that are the owners of this SCL.  Once the SCL and SCL Metapackage are approved, the owners will be listed in the PackageDB as the Owners of the SCL Metapackage.  This section is who to contact before approval.
Specific people that are the owners of this SCL.  Once the SCL and SCL Metapackage are approved, the owners will be listed in the PackageDB as the Owners of the SCL Metapackage.  This section is who to contact before approval.
-->
-->
* Names: [[User:FASAcountName| Your Name]]
* Names:
<!-- Include email addresses that the maintainers can be reached should people want to contact you about helping with the SCL or technical issues need to be resolved. -->
** [[User:FASAcountName| Maintainer Name]] - <email address>  <!-- email addresses may be used to reach the maintainers prior to the SCL being approved -->
* Email: <email addresses for the maintainers so we can contact you about any specific technical issues.>
** [[User:FASAcountName| Maintainer2 Name]] - <maintainer2 email address>


== Detailed Description ==
== Detailed Description ==
<!-- Expand on the summary, if appropriate.  A couple sentences suffices to explain the goal, but the more details you can provide the better. -->
<!-- Expand on the summary, if appropriate.  A couple sentences suffices to explain the goal, but the more details you can provide the better. This should let end users know more about the platform that the SCL is attempting to create.  -->


== Packages in the Platform ==
== Packages in the Platform ==
<!-- The platform that the SCL is creating is implemented by a set of rpm packages.  There may be additional packages in Fedora that are built for the SCL but are not part of the platform.  This section of the SCL Definition makes it clear to end users what packages are part of the platform so they do not have false expectations.  -->
The following packages are part of the platform that this SCL implements.  Packages which are built for the SCL but not mentioned here are not part of the platform and may be removed or changed in incompatible ways according to normal Fedora Policies (Usually, when a new release of Fedora is made).
* <package name>
* <package2 name>
=== Compatibility Guarantees ===
=== Compatibility Guarantees ===


<!-- Do not erase the following lineIt's there to warn end users: -->
The packages in an SCL's platform are often more concerned with maintaining backwards compatibility than other packages in Fedora as SCLs exist to provide you with a more stable platform to build your own cross-platform software.  As such, many of the packages in the SCL have specific compatibility guarantees.  This section defines which packages in this SCL have more strict backwards compatibility guarantees and what those guarantees are so that you know what to expect.
 
<!-- Do not erase the following two linesThey're there to warn end users: -->
{{admon/warning|Security trumps compatibility|If a security issue needs to be fixed but that breaks backwards compatibility, the security issue will be fixed despite violating the guarantee. This page will be updated to mention the Fedora versions and the version of the relevant packages from the SCL which needed a backwards incompatible change to fix the issue).}}
{{admon/warning|Security trumps compatibility|If a security issue needs to be fixed but that breaks backwards compatibility, the security issue will be fixed despite violating the guarantee. This page will be updated to mention the Fedora versions and the version of the relevant packages from the SCL which needed a backwards incompatible change to fix the issue).}}
{{admon/warning|Guarantees are only best effort|SCL maintainers attempt to keep these backwards compatibility guarantees but the guarantees are not set in stone.  As an example, the guarantees could be changed if the maintainer of an SCL decides to orphan it and someone new takes over.  The new maintainer may decide to guarantee backwards compatibility for a smaller set of packages or make incompatible updates to some of the existing packages.  These types of changes can only occur between Fedora releases.}}
<!-- Fill in this section with any guarantees you wish to make for packages in the SCL.  See https://fedoraproject.org/wiki/User:Toshio/SCL_Guidelines_%28draft%29#Compatibility_Guarantees for examples of what makes a good guarantee. -->
== Release Notes and Change History ==
<!-- Change N to the Fedora release that this SCL is first appearing in -->
=== Fedora N  ===
<!-- Fill in this section with information that should go in the release notes for this new SCL -->
<!-- If the Compat Guarantees change or you must change something in the Compat Guarantees in an incompatible manner be sure to update this section with additional entries:
=== Fedora N2 ===
* Had to change the behaviour of url.get() when retrieving https sites due to security risk.  This function now fails if the server's certificates are invalid or cannot be verified.  An optional parameter, allow_broken, can restore the former behaviour if you are willing to assume the security risk.
* The db library code was updated because upstream no longer supports the old library and the old code had too many security flaws.  The new version has an incompatible file format.  We ship a script /usr/bin/convert_db that can convert from the old format to the new one but it must be run on each db file before the library can read it.  It's beyond the scope of this SCL to determine what an application chooses to do if it encounters a db file it doesn't know what to do with so there's the chance that an application may choose to overwrite old db files instead of letting you upgrade them.  Please take backups.
-->


(Bug for bug compat?)
()


<!-- When your SCL Request is completed and ready for review and announcement
[[Category:SCL Definiton (draft)]]
<!-- When your SCL Request is ready for review by the FPC:
     * Go to https://fedorahosted.org/fpc/
     * Go to https://fedorahosted.org/fpc/
     * Log in with your Fedora Account
     * Log in with your Fedora Account
     * Open a new ticket https://fedorahosted.org/fpc/newticket
     * Open a new ticket https://fedorahosted.org/fpc/newticket
     * Set the Component to SCL Request
     * Set the Component to SCL Request
    * In the description, be sure to link to this page.
   -->
   -->

Latest revision as of 18:21, 22 May 2014

Important.png
Comments and Explanations
The page source contains comments providing guidance to fill out each section. They are invisible when viewing this page. To read it, choose the "edit" link.
Copy the source to a new page before making changes! DO NOT EDIT THIS TEMPLATE FOR YOUR SCL REQUEST.


Warning.png
This page is a draft only
It is still under construction and content may change. Do not rely on the information on this page. This is a draft SCL Definition. It needs to be approved by the FPC before an SCL following this draft can be created. The FPC uses the criteria on https://fedoraproject.org/wiki/User:Toshio/SCL_Guidelines_(draft)#SCL_Criteria to evaluate whether the SCL is okay for Fedora.


SCL Name

Summary

Maintainers

Detailed Description

Packages in the Platform

The following packages are part of the platform that this SCL implements. Packages which are built for the SCL but not mentioned here are not part of the platform and may be removed or changed in incompatible ways according to normal Fedora Policies (Usually, when a new release of Fedora is made).

  • <package name>
  • <package2 name>

Compatibility Guarantees

The packages in an SCL's platform are often more concerned with maintaining backwards compatibility than other packages in Fedora as SCLs exist to provide you with a more stable platform to build your own cross-platform software. As such, many of the packages in the SCL have specific compatibility guarantees. This section defines which packages in this SCL have more strict backwards compatibility guarantees and what those guarantees are so that you know what to expect.

Warning.png
Security trumps compatibility
If a security issue needs to be fixed but that breaks backwards compatibility, the security issue will be fixed despite violating the guarantee. This page will be updated to mention the Fedora versions and the version of the relevant packages from the SCL which needed a backwards incompatible change to fix the issue).
Warning.png
Guarantees are only best effort
SCL maintainers attempt to keep these backwards compatibility guarantees but the guarantees are not set in stone. As an example, the guarantees could be changed if the maintainer of an SCL decides to orphan it and someone new takes over. The new maintainer may decide to guarantee backwards compatibility for a smaller set of packages or make incompatible updates to some of the existing packages. These types of changes can only occur between Fedora releases.


Release Notes and Change History

Fedora N