#2528 doc: python support matrix
Merged 2 years ago by tkopecek. Opened 2 years ago by tkopecek.
tkopecek/koji issue356  into  master

file modified
+1
@@ -49,6 +49,7 @@ 

      content_generator_metadata

      configuring_jenkins

      utils

+     supported_platforms

  

  HowTos

  ======

@@ -0,0 +1,13 @@ 

+ Supported Platforms

+ ===================

+ 

+ We're now supporting Linux systems which have at least python 2.7 for

+ builders and 3.6 for other components. These versions are minimal (so,

+ everywhere where is 2.7 support it means 2.7+ *and* 3.0+. Currently it

+ involves all active Fedoras and RHEL/CentOS 7+.

+ 

+ +-----------+-----+-----+---------+-------+-----+-----+

+ | Component | Hub | Web | Builder | Utils | Lib | CLI |

+ +===========+=====+=====+=========+=======+=====+=====+

+ | Python    | 3.6 | 3.6 | 2.7     | 3.6   | 2.7 | 2.7 |

+ +-----------+-----+-----+---------+-------+-----+-----+

@@ -14,6 +14,11 @@ 

  understanding of Koji's architecture to be able to estimate how much

  work is still ahead of them.

  

+ Koji is written to support a variety of platforms and python versions,

+ with some portions of Koji supported over a larger set than others.

+ When making changes, please be considerate of those

+ :doc:`supported_platforms`.

+ 

  Task Flow

  =========

  

Metadata Update from @tkopecek:
- Pull-request tagged with: doc

2 years ago

Metadata Update from @tkopecek:
- Pull-request tagged with: no_qe

2 years ago

rebased onto d677f30e34d8c2846a398bfaa9d3a205b825a31b

2 years ago

I'm not sure if this belongs under the release process heading. For that matter, I'm not sure it belongs in the writing_koji_code document. The support matrix is of interest to folks that never look at code.

Minor: "Linux" should be capitalized.

As far as the table goes, we should probably indicate some sort of range. I guess 3.6 means 3.6+, but perhaps we should be explicit. Likewise, for the lib and cli, we of course support python versions over 2.7.

Maybe it would be better to have a "Supported Platforms" document that includes this matrix leaves us room for more explanation.

We could link that document in the writing_koji_code file with a note along the lines of: "Koji is written to support a variety of platforms and python versions, with some portions of Koji supported over a larger set than others. When making changes, please be considerate of those supported platforms [link].

rebased onto b2892db

2 years ago

There is an empty section in writing_koji_code now ("Supported OS"). Did you mean to remove this in favor of the addition under "Getting started" or should this also have a link to the new page?

1 new commit added

  • remove empty section
2 years ago

pretty please pagure-ci rebuild

2 years ago

Commit f12c92d fixes this pull-request

Pull-Request has been merged by tkopecek

2 years ago