Hello list,
I am writing to share with you all an updated Pure Data Reference Card I made. Because Pd has evolved so much in the last 8 years and I find the ref. card very useful both for me and for my students, I decided to update it and try to keep it up to date from now on. An Italian version of the ref. card is also in the works, and will be available on the GitHub soon (https://github.com/NiccoloGranieri/Pure-Data-Refcards https://github.com/NiccoloGranieri/Pure-Data-Refcards).
In the process of compiling the ref. card I noticed a few things in the help-intro.pd file and decided to share them here rather than on the issue tracker.
In the top intro section of the help file, there is a reference to an "Add" menu. I think that has been renamed to "Put" now. This might confuse beginners. [tabread] and [tabread4] have the same description, no mention of the 4 point interpolation as in [tabread4~]
Thanks for all the hard work developing Pure Data,
Niccolò Granieri | PhD Student @ Integra Lab | niccologranieri.com http://niccologranieri.com/ Royal Birmingham Conservatoire | Birmingham City University | B4 7XG
Yay, splendid, well done. Agreed it's a very useful item, especially now updated.
J
On Fri, 9 Nov 2018 at 17:21, Niccolò Granieri granieriniccolo@gmail.com wrote:
Hello list,
I am writing to share with you all an updated Pure Data Reference Card I made. Because Pd has evolved so much in the last 8 years and I find the ref. card very useful both for me and for my students, I decided to update it and try to keep it up to date from now on. An Italian version of the ref. card is also in the works, and will be available on the GitHub soon ( https://github.com/NiccoloGranieri/Pure-Data-Refcards).
In the process of compiling the ref. card I noticed a few things in the *help-intro.pd* file and decided to share them here rather than on the issue tracker.
- In the top intro section of the help file, there is a reference to
an "Add" menu. I think that has been renamed to "Put" now. This might confuse beginners.
- [tabread] and [tabread4] have the same description, no mention of
the 4 point interpolation as in [tabread4~]
Thanks for all the hard work developing Pure Data,
Niccolò Granieri | PhD Student @ Integra Lab | niccologranieri.com Royal Birmingham Conservatoire | Birmingham City University | B4 7XG
Pd-dev mailing list Pd-dev@lists.iem.at https://lists.puredata.info/listinfo/pd-dev
Hi Niccolò,
I'd suggest you add a rendered pdf file of the ref card to the repository as I assume not every pd user is familiar with LaTex rendering and it's only an extra 250 KB anyway.
-- Orm
On Fri, 9 Nov 2018 at 17:21, Niccolò Granieri granieriniccolo@gmail.com wrote:
Hello list,
I am writing to share with you all an updated Pure Data Reference Card I made. Because Pd has evolved so much in the last 8 years and I find the ref. card very useful both for me and for my students, I decided to update it and try to keep it up to date from now on. An Italian version of the ref. card is also in the works, and will be available on the GitHub soon ( https://github.com/NiccoloGranieri/Pure-Data-Refcards).
In the process of compiling the ref. card I noticed a few things in the *help-intro.pd* file and decided to share them here rather than on the issue tracker.
- In the top intro section of the help file, there is a reference to
an "Add" menu. I think that has been renamed to "Put" now. This might confuse beginners.
- [tabread] and [tabread4] have the same description, no mention of
the 4 point interpolation as in [tabread4~]
Thanks for all the hard work developing Pure Data,
Niccolò Granieri | PhD Student @ Integra Lab | niccologranieri.com Royal Birmingham Conservatoire | Birmingham City University | B4 7XG
Pd-dev mailing list Pd-dev@lists.iem.at https://lists.puredata.info/listinfo/pd-dev
Hi Orm,
I didn't render the pdf in the repository just because historically that's how it was done before hand. The repository contained only the LaTeX files, and the English pdf file was hosted on https://puredata.info/docs/tutorials/pd-refcard https://puredata.info/docs/tutorials/pd-refcard.
If that's not how we want to proceed anymore I can include a render for each language in the GitHub, maybe under releases, and also host the pdf's on my personal website to make them easier to find.
I'm up for anything, just wanted to check with the dev list first.
Thanks for the feedback, Niccolò Granieri | PhD Student @ Integra Lab | niccologranieri.com http://niccologranieri.com/ Royal Birmingham Conservatoire | Birmingham City University | B4 7XG
On 10 Nov 2018, at 10:13, Orm Finnendahl orm.finnendahl@selma.hfmdk-frankfurt.de wrote:
Hi Niccolò,
I'd suggest you add a rendered pdf file of the ref card to the repository as I assume not every pd user is familiar with LaTex rendering and it's only an extra 250 KB anyway.
-- Orm
On Fri, 9 Nov 2018 at 17:21, Niccolò Granieri granieriniccolo@gmail.com wrote:
Hello list,
I am writing to share with you all an updated Pure Data Reference Card I made. Because Pd has evolved so much in the last 8 years and I find the ref. card very useful both for me and for my students, I decided to update it and try to keep it up to date from now on. An Italian version of the ref. card is also in the works, and will be available on the GitHub soon ( https://github.com/NiccoloGranieri/Pure-Data-Refcards).
In the process of compiling the ref. card I noticed a few things in the *help-intro.pd* file and decided to share them here rather than on the issue tracker.
- In the top intro section of the help file, there is a reference to
an "Add" menu. I think that has been renamed to "Put" now. This might confuse beginners.
- [tabread] and [tabread4] have the same description, no mention of
the 4 point interpolation as in [tabread4~]
Thanks for all the hard work developing Pure Data,
Niccolò Granieri | PhD Student @ Integra Lab | niccologranieri.com Royal Birmingham Conservatoire | Birmingham City University | B4 7XG
Pd-dev mailing list Pd-dev@lists.iem.at https://lists.puredata.info/listinfo/pd-dev
I thought so. So is anyone in charge of the puredata.info http://puredata.info/ website, and can update the pdf that is as of now obsolete? Or should we just take the old pdf down and host everything on GitHub?
If we plan to host on the puredata.info http://puredata.info/ it would be nice anyway to link to an "always up-to-date" version of the refcard. Niccolò Granieri | PhD Student @ Integra Lab | niccologranieri.com http://niccologranieri.com/ Royal Birmingham Conservatoire | Birmingham City University | B4 7XG
On 10 Nov 2018, at 11:42, IOhannes m zmoelnig zmoelnig@iem.at wrote:
On 10.11.18 11:25, Niccolò Granieri wrote:
If that's not how we want to proceed anymore I can include a render for each language in the GitHub, maybe under releases,
+1 adding generated files to the *repository* itself is a bad idea in general.
gfmadsr IOhannes
Pd-dev mailing list Pd-dev@lists.iem.at https://lists.puredata.info/listinfo/pd-dev
Hi,
Am Samstag, den 10. November 2018 um 11:42 Uhr schrieb IOhannes m zmoelnig:
adding generated files to the *repository* itself is a bad idea in general.
???
It is common practice for an abundant number of software projects to put rendered examples in binary format or their documentation in different formats (html, pdf) into dedicated folders of the repo even if the source files of them are distributed as well.
Especially in the case of a pdf and considering its size I don't really see the point in omitting it. If "cleanness" is the issue here, I'd suggest to put up a dedicated, adequately named repo at github with only the pdfs. As pdf is a programming language you'd be putting program sources online ;-)
-- Orm
On 11/10/18 6:43 PM, Orm Finnendahl wrote:
Hi,
Am Samstag, den 10. November 2018 um 11:42 Uhr schrieb IOhannes m zmoelnig:
adding generated files to the *repository* itself is a bad idea in general.
???
It is common practice for an abundant number of software projects to put rendered examples in binary format
that doesn't make it any better practice. what's the benefit of putting volatile binary data into a repository?
most users don't ever have a need to to visit the repository. a repository is for source code. it is *not* the place to download binaries from. for this you have "release pages" or whatever. so the proper solution is to direct the end users to the proper place to get the built-data.
gfmards IOhannes
Hey IOhannes,
Am Samstag, den 10. November 2018 um 19:28:44 Uhr (+0100) schrieb IOhannes m zmoelnig:
a repository is for source code. it is *not* the place to download binaries from. for this you have "release pages" or whatever.
Git repositories have proven useful for all kinds of purposes, often far beyond their intended use and I'd recommend a more relaxed attitude.
so the proper solution is to direct the end users to the proper place to get the built-data.
I agree. We probably just disagree about the matter what qualifies a place to be proper. I would argue that this has changed drastically in the last 10 years and putting useful documents to github isn't such a bad idea.
-- Orm
I will add a README file to the repo that will better explain how to obtain the compiled pdf files without necessarily adding them to the repo.
Ultimately it would be nice to replace the obsolete version of the pdf from the puredata.info http://puredata.info/ site as well. So if anyone knows who has admin access to that site, please get in touch.
Thanks for the feedback, Niccolò Granieri | PhD Student @ Integra Lab | niccologranieri.com http://niccologranieri.com/ Royal Birmingham Conservatoire | Birmingham City University | B4 7XG
On 10 Nov 2018, at 19:51, Orm Finnendahl orm.finnendahl@selma.hfmdk-frankfurt.de wrote:
Hey IOhannes,
Am Samstag, den 10. November 2018 um 19:28:44 Uhr (+0100) schrieb IOhannes m zmoelnig:
a repository is for source code. it is *not* the place to download binaries from. for this you have "release pages" or whatever.
Git repositories have proven useful for all kinds of purposes, often far beyond their intended use and I'd recommend a more relaxed attitude.
so the proper solution is to direct the end users to the proper place to get the built-data.
I agree. We probably just disagree about the matter what qualifies a place to be proper. I would argue that this has changed drastically in the last 10 years and putting useful documents to github isn't such a bad idea.
-- Orm
Pd-dev mailing list Pd-dev@lists.iem.at https://lists.puredata.info/listinfo/pd-dev
I *think* you can just ask for write access
On Mon, 12 Nov 2018 at 12:11, Niccolò Granieri granieriniccolo@gmail.com wrote:
I will add a README file to the repo that will better explain how to obtain the compiled pdf files without necessarily adding them to the repo.
Ultimately it would be nice to replace the obsolete version of the pdf from the puredata.info site as well. So if anyone knows who has admin access to that site, please get in touch.
Thanks for the feedback,
Niccolò Granieri | PhD Student @ Integra Lab | niccologranieri.com Royal Birmingham Conservatoire | Birmingham City University | B4 7XG
On 10 Nov 2018, at 19:51, Orm Finnendahl < orm.finnendahl@selma.hfmdk-frankfurt.de> wrote:
Hey IOhannes,
Am Samstag, den 10. November 2018 um 19:28:44 Uhr (+0100) schrieb IOhannes m zmoelnig:
a repository is for source code. it is *not* the place to download binaries from. for this you have "release pages" or whatever.
Git repositories have proven useful for all kinds of purposes, often far beyond their intended use and I'd recommend a more relaxed attitude.
so the proper solution is to direct the end users to the proper place to get the built-data.
I agree. We probably just disagree about the matter what qualifies a place to be proper. I would argue that this has changed drastically in the last 10 years and putting useful documents to github isn't such a bad idea.
-- Orm
Pd-dev mailing list Pd-dev@lists.iem.at https://lists.puredata.info/listinfo/pd-dev
Pd-dev mailing list Pd-dev@lists.iem.at https://lists.puredata.info/listinfo/pd-dev
-
IOhannes m zmoelnig -
IOhannes m zmölnig
-
Julian Brooks -
Niccolò Granieri -
Orm Finnendahl