Are issues and pull requests useful/welcome?

[rrthomas]

I can't easily tell from the documentation where to submit fixes for this code, or indeed whether this repository is even usefully canonical: the file AFDKO-Overview.html talks about "this release of the Adobe Font Development Kit", which suggests that what is on github is just a one-off version, not something to be maintained.

Similarly, there are some deficiencies in the documentation (first section of Read Me First doesn't mention Linux, causing confusion) and installation procedure (tries to symlink to ~/bin, a directory that I, for one, don't have) it would be nice to correct, but only if the corrections will improve the AFDKO long-term.

Read_Me_First says: "Adobe has set up a web site where the new versions can be downloaded. The FDK download web site is at the AFDKO Download site", which is discouraging, as that doesn't help me track versions or issues. The file doesn't even mention Github, hence my caution.

So, in sum, is Github just a release platform here, or can I actually use it the way I would with any normal software project?

[jackjennings]

👍 would also like to know

[readroberts]

The GITHUB repository for the AFDK is the one and only official source for the OpenSource AFDKO tools and sources, now and going forwards. Fixing these sources with push and issue requests is not only useful, it is the only place where fixes will be maintained.

Since most type designers are not technically oriented enough to build the AFDKO tools from sources, Adobe provides an installable download of the AFDKO, with everything already built. This download is likely to get updated only a few times year. When it is rebuilt, it will be built from the current state of the GitHub repository. There will be no separate development branch for the download from the Adobe site.

I will amend the documentation to make this clear.

• Read Roberts

[rrthomas]

Thanks very much for the clarification, and TIA for the upcoming clarification in the documentation.

[miguelsousa]

@readroberts I think it would be helpful to have those downloads in the Releases page of the repository as well. But first you should add tags to some of the commits.