From: Andreas K. <aku...@sh...> - 2019-04-10 04:02:05
|
Hello to all 45 of you with an account at the Tcllib repository which has an email address in the contact field. I assume that you are at least a user of Tcllib, and possibly even a contributor or maintainer for one or more of its packages. I am broadcasting this message to all of you because I do not know who of you is also subscribed to the [Tcllib-devel](https://lists.sourceforge.net/lists/listinfo/tcllib-devel) [mailing list](mail:tcl...@li...). The list is cc'd however, to keep things open. With the administrative stuff done, let us come to the meat. If you are tracking Tcllib's [timeline](https://core.tcl.tk/tcllib/timeline) you might have seen that I am currently working in a branch [1] on a full set of guides for the various roles (user, installer/builder, developer/maintainer, release manager) associated with Tcllib. While there are still substantial holes in the guide for a release manager I believe that the other guides are now pretty complete, i.e. ready for a larger review of their contents. I am looking for feedback on things as simple as spelling and phrasing, up to higher-level discussion about maintainer commitments and the purpose of branches, how to work with them, etc. If you are (planning to be) a maintainer for one or more packages the [Maintainer commitments](https://core.tcl.tk/tcllib/doc/doc-overhaul/embedded/m d/tcllib/files/devdoc/tcllib_devguide.md#subsection2) are especially important and should be reviewed. While I tried to be sensible it is entirely possible that I did not succeed. The 'kind communication' part is essentially a belaboring of `be kind to each other when discussing things`. Very easy to forget, as such I believe the reminder is necessary. The plan is to integrate the feedback and then later merge the branch back to the trunk, at which point the guides would become official. All the new documentation is reachable via the new [Index Page](https://core.tcl.tk/tcllib/doc/doc-overhaul/embedded/index.md), in the section "Guides To Tcllib" at the top. __Note__ that the link points to a document on the branch, this is not yet the main index serving as Tcllib's homepage. To keep a modicum of forward momentum I am limiting the feedback period to a bit under three weeks, starting from now to Sunday April 28, 2019, 12:00 GMT. This is `clock format 1556452800`. ~ ~ ~~ ~~~ ~~~~~ ~~~~~~~~ ~~~~~~~~~~~~~ [1]: https://core.tcl.tk/tcllib/timeline?r=doc-overhaul "doc-overhaul" -- See you, Andreas Kupries <aku...@sh...> <http://core.tcl.tk/akupries/> Developer @ SUSE Software Canada ULC <and...@su...> EuroTcl 2019, Jun 29-30, Nuernberg/DE, http://eurotcl.eu/ Tcl'2019, Nov 4-8, Houston, TX, USA. http://www.tcl.tk/community/tcl2019/ ------------------------------------------------------------------------------- |