More updates for installation and developer guides

[mkoeppe]

In this ticket:

• (from #33426 comment:18) The link on the index page still goes to the wiki, which should be probably changed now that the relevant instructions are migrated. ​https://516701dbc7dd9738fb9d77ee3ac210c3919c8cb3--sagemath-tobias.netlify.app/installation/index.html
• (follow up from Update section "Sage Development Process" in Developer's Guide #29784) Also should explain configure --enable-editable (https://wiki.sagemath.org/ReleaseTours/sage-9.3#Editable_.28.22in-place.22.2C_.22develop.22.29_installs_of_the_Sage_library)
• The "install from source" chapter of the installation manual could be changed so that it points to README.md from the very beginning

See also:

• README Build from Source: m4 (step 5) is needed to run make configure (step 3) #33553 README Build from Source: m4 (step 5) is needed to run make configure (step 3)
• add more details on conda-based installations of Sage #33426 add more details on conda-based installations of Sage
• Extend documentation on how to set up the virtual environment #31342 Extend documentation on how to set up the virtual environment
• Update/reorder git instructions in Developer's Guide #33648 Update/reorder git instructions in Developer's Guide
• Developer's Guide: Update reviewer's check list from wiki #33649 Developer's Guide: Update reviewer's check list from wiki
• Document using Sage on Windows via Visual Studio Code with WSL remote #30484 Documentation/configuration for Sage on Windows using Visual Studio (vscode) with a WSL remote
• Installation guide: Change "install from source" chapter so that it only provides extra detail in the same order as README.md #33662 Installation guide: Change "install from source" chapter so that it only provides extra detail in the same order as README.md

Depends on #33426

CC: @tobiasdiez @sagetrac-tmonteil @seblabbe @dimpase @yuan-zhou @isuruf

Component: documentation

Author: Matthias Koeppe, Yuan Zhou

Branch/Commit: 8716d80

Reviewer: Dima Pasechnik

Issue created by migration from https://trac.sagemath.org/ticket/33088

[mkoeppe]

Dependencies: #29784

[mkoeppe]

Changed dependencies from #29784 to #29784, #33131

[mkoeppe]

Changed dependencies from #29784, #33131 to #33426

[mkoeppe]

Branch: u/mkoeppe/more_updates_for_installation_and_developer_guides

[mkoeppe]

Commit: b6f0404

[mkoeppe]

New commits:

8e363ef	src/doc/en/installation/source.rst: Update conda sections from https://wiki.sagemath.org/Conda
10015e6	src/doc/en/installation/conda.rst: Move everything on conda (except disabling it) here from source.rst
6432a02	src/doc/en/developer/walk_through.rst: Link also to ../installation/conda.html
d190d13	src/doc/en/constructions/interface_issues.rst: Remove outdated short installation instructions
516701d	README.md: Use more specific link to 'Install from Source Code' section
3d5d531	Merge #33426
b6f0404	src/doc/en/installation/index.rst: Point to conda section in the manual, not the wiki

[mkoeppe]

Author: Matthias Koeppe, ...

[sagetrac-git]

Branch pushed to git repo; I updated commit sha1. New commits:

6cf090e	README.md: Point first to the decision tree in the installation guide; remove mention of binaries
296fd12	README.md: Prefer WSL to Cygwin

[sagetrac-git]

Changed commit from b6f0404 to 296fd12

[sagetrac-git]

Changed commit from 296fd12 to 9140ee7

[sagetrac-git]

Branch pushed to git repo; I updated commit sha1. New commits:

9140ee7

README.md [macOS]: Only need the Xcode CLT, not actual Xcode; remove instructions for ancient macOS

[yuan-zhou]

comment:24

On page 5 of the age Developer's Guide pdf, in the section "branching out":

[user@localhost]$ git branch
* develop
  master

This probably should be [user@localhost sage], to be consistent with the other boxes.

[mkoeppe]

comment:25

Good idea, do you want to push a commit?

[sagetrac-git]

Branch pushed to git repo; I updated commit sha1. New commits:

3f6c6e0

src/doc/en/developer/workspace.rst: Link to Trac #30500

[sagetrac-git]

Changed commit from f1e1166 to 3f6c6e0

[mkoeppe]

Changed author from Matthias Koeppe, Yuan Zhou... to Matthias Koeppe, Yuan Zhou

[dimpase]

comment:47

can we have this:

for Sage 9.2, these modules are as follows: ``sqlite3``, ``ctypes``, ``math``,
...

up to date? (i.e. for the upcoming 9.6)

[dimpase]

comment:48

By the way, what's the state of building Sage on macOS with Homebrew tools only? Can it be done?
Or it still needs a part of xcode installed (headers?) ?

[dimpase]

comment:49

Other than comment:47, looks good.

[mkoeppe]

comment:50

Replying to @dimpase:

By the way, what's the state of building Sage on macOS with Homebrew tools only? Can it be done?
Or it still needs a part of xcode installed (headers?) ?

Homebrew itself requires CLT. See https://docs.brew.sh/Installation#macos-requirements and the README.md modified in this ticket.

[isuruf]

comment:51

Slight related: with conda you only need the SDK (headers) from xcode.

[sagetrac-git]

Branch pushed to git repo; I updated commit sha1. New commits:

8716d80

src/doc/en/installation/source.rst: Update required venv Python extension modules from build/pkgs/python3/spkg-configure.m4

[sagetrac-git]

Changed commit from 3f6c6e0 to 8716d80

[dimpase]

Reviewer: Dima Pasechnik

[dimpase]

comment:53

ok, thanks!

[mkoeppe]

comment:54

Thank you!

[vbraun]

Changed branch from u/mkoeppe/more_updates_for_installation_and_developer_guides to 8716d80