Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chore!: join IDE and editors into same section #7065

Merged

Conversation

davorpa
Copy link
Member

@davorpa davorpa commented Sep 9, 2022

What does this PR do?

Add info | Improve repo

For resources

Description

This homogenize the place where are organized the IDE and editors like Vim, Emacs, Visual Studio, Visual Studio Code, Eclipse, IntelliJ... into the same section.

Emacs Lisp is a language per sé. so apply and add some crosslinks #5535 in order to reference editors.

Moved books in -langs.md now are in -subjects.md since editors are language agnostic, I think.

At last but not least, complete this moved resources with author, formats and notes

Checklist:

  • Read our contributing guidelines.
  • Search for duplicates.
  • Include author(s) and platform where appropriate.
  • Put lists in alphabetical order, correct spacing.
  • Add needed indications (PDF, access notes, under construction).
  • Used an informative name for this pull request.

Follow-up

  • Check the status of GitHub Actions and resolve any reported warnings!

This homogenize the place where are organized the IDE and editors like Vim, Emacs, Visual Studio, Visual Studio Code, Eclipse, IntelliJ... into the same section.

Emacs Lips is a language per sé. so apply and add some crosslinks EbookFoundation#5535 in order to reference editors.

Moved books in `-langs.md` now are in `-subjects.md` since editors are language agnostic, I think.

Complete this moved resources with author, formats and notes
@davorpa davorpa added 🗣️ locale:en Resources addressing "English" language 🗣️ locale:es Resources addressing "Spanish / español" language 🗣️ locale:fr Resources addressing "French / français" language 🗣️ locale:pt Resources addressing "Portuguese / Brazilian" language 🗣️ locale:ru Resources addressing "Russian / Русский язык" language 🗣️ locale:zh Resources addressing "Chinese" language 🗣️ locale:ja Resources addressing "Japanese / 日本語" language 🗣️ locale:id Resources addressing "Indonesian" language 🗣️ locale:tr Resources addressing "Turkish / Türkçe" language 🗣️ locale:bn Resources addressing "Bengali / বাংলা" language labels Sep 9, 2022
@davorpa davorpa self-assigned this Sep 9, 2022
@davorpa davorpa added the linter error Please, correct build errors found by linter! label Sep 9, 2022
https://github.com/EbookFoundation/free-programming-books/runs/8267734103?check_suite_focus=true

Run fpb-lint ./books/
books/free-programming-books-ja.md
  4:5-22:42  warning  Alphabetical ordering: swap l.22 and l.21  alphabetize-lists  remark-lint

books/free-programming-books-pt_BR.md
  58:1-61:70  warning  Alphabetical ordering: swap l.60 and l.59  alphabetize-lists  remark-lint

books/free-programming-books-zh.md
  254:1-258:87  warning  Alphabetical ordering: swap l.258 and l.257  alphabetize-lists  remark-lint
@davorpa davorpa removed the linter error Please, correct build errors found by linter! label Sep 9, 2022
@davorpa davorpa marked this pull request as ready for review September 9, 2022 10:15
@eshellman
Copy link
Collaborator

I think this is a good move. Emacs lisp is a dialect of lisp, so probably belongs in lisp

@davorpa davorpa mentioned this pull request Sep 9, 2022
39 tasks
@davorpa
Copy link
Member Author

davorpa commented Sep 9, 2022

I think this is a good move. Emacs lisp is a dialect of lisp, so probably belongs in lisp

From Wikipedia...

Lisp (historically LISP) is a family of programming languages with a long history and a distinctive, fully parenthesized prefix notation.[3] Originally specified in 1958, Lisp is the second-oldest high-level programming language still in common use. Only Fortran is older, by one year.[4][5] Lisp has changed since its early days, and many dialects have existed over its history. Today, the best-known general-purpose Lisp dialects are Racket, Common Lisp, Scheme, and Clojure.[citation needed]

Doing a search, we have actually sections named with...

  • Common Lisp
  • Lisp
  • PicoLisp
  • Emacs Lisp
  • Clojure
  • Racket
  • Scheme

What do you prefer? All together (Pico/Emacs Lisp) in Lisp or in subsections or even with crosslinks? The others scoped to other PR?

- Common Lisp, PicoLisp, Emacs Lisp -> Lisp
- Rename Common Lisp and LISP -> Lisp
- Emacs & Pico as subsections of Lisp preserving current crosslinks
@davorpa davorpa force-pushed the maintenance/ide-editors-section branch from f730c31 to 963f96b Compare September 9, 2022 21:50
@eshellman
Copy link
Collaborator

Would someone looking for a book on Clojure or Scheme know that it is a lisp "dialect"? I didn't. They have enough books to merit their own sections though. EmacsLisp has only one book though?

@davorpa
Copy link
Member Author

davorpa commented Sep 12, 2022

Would someone looking for a book on Clojure or Scheme know that it is a lisp "dialect"? I didn't. They have enough books to merit their own sections though. EmacsLisp has only one book though?

Ok. last update... 0a83d41 Please review again.

I don't do the same in file -langs.md because have a cross reference to editors in -subjects.md.

https://github.com/davorpa/free-programming-books/blob/0a83d41b9878093db760016cedfcafbb63c26a33/books/free-programming-books-langs.md?plain=1#L1396-L1431

Let me know how to resolve in case of want to change it too.

@eshellman eshellman merged commit 4d67825 into EbookFoundation:main Sep 13, 2022
davorpa added a commit to davorpa/free-programming-books that referenced this pull request Sep 17, 2022
…es to solve conflicts

Cherry pick until commit 4d67825 + 0a83d41
@davorpa davorpa deleted the maintenance/ide-editors-section branch September 21, 2022 21:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
🗣️ locale:bn Resources addressing "Bengali / বাংলা" language 🗣️ locale:en Resources addressing "English" language 🗣️ locale:es Resources addressing "Spanish / español" language 🗣️ locale:fr Resources addressing "French / français" language 🗣️ locale:id Resources addressing "Indonesian" language 🗣️ locale:ja Resources addressing "Japanese / 日本語" language 🗣️ locale:pt Resources addressing "Portuguese / Brazilian" language 🗣️ locale:ru Resources addressing "Russian / Русский язык" language 🗣️ locale:tr Resources addressing "Turkish / Türkçe" language 🗣️ locale:zh Resources addressing "Chinese" language
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants