diff --git a/docs/INSTALLATION.md b/docs/INSTALLATION.md index 997cfb5b..450c3727 100644 --- a/docs/INSTALLATION.md +++ b/docs/INSTALLATION.md @@ -2,18 +2,22 @@ The Factor track uses **Factor 0.101**. Earlier versions are not supported. -You can either install a [nightly](#nightly) build (which tracks 0.101+ from `master`) or [build from source](#autobuild-from-source). +You can install a [stable](#stable) or [nightly](#nightly) build, or [build from source](#build-from-source). Verify your installation by running `factor -e='vm-version print'` — it should print `0.101` or higher. +--- +### Stable + + provides stable binaries under the "Stable release" section. + --- ### Nightly provides nightly binaries under the "Development release" section. These binaries are built from git, but only builds that pass are shown. --- - -### (Auto)build from source +### build from source If you want the bleeding edge and even nightly is too old for you, then you will need a modern C++ compiler (GCC >=4.8 or Clang >=3.5), `make`, and `curl`. @@ -65,9 +69,3 @@ Clone the [repository](https://github.com/factor/factor) and use `make` in that If `make` fails with an error about a non-present target, try `make factor` or, if you can read a Makefile, find the make target for your platform in `GNUmakefile`. If *that* fails, open an issue on [factor/factor](https://github.com/factor/factor) containing the error -- the friendly developers will be happy to help. - ---- - -#### Stable (not recommended) - -**Stable releases predate Factor 0.101 and are not supported.** Use a [nightly build](#nightly) or build from source. \ No newline at end of file diff --git a/docs/LEARNING.md b/docs/LEARNING.md index 0b73a375..2e008fd2 100644 --- a/docs/LEARNING.md +++ b/docs/LEARNING.md @@ -10,8 +10,6 @@ There are many great resources for learning Factor. * Documentation is an important part of every good Factor vocabulary. Consequently, Factor's amazing and extensive docs are available offline, searchable right from the GUI Listener, or on the command line. These same docs, equally searchable, can be found online.
-* Factor's GitHub repository hosts a Wiki.
- * Björn Lindqvist, one of Factor's developers, has a repo full of interesting tips and tricks. It's not updated very often and is WIP (and much of its content is being moved to the GitHub Wiki), but it's still very cool stuff.
* [Learn X in Y Minutes][learn-x-in-y-minutes] is a good resource for many languages, and Factor is no exception. Its tutorial is not *extensive* by any means, but it is a good reference and enough to get you started.
@@ -20,8 +18,6 @@ There are many great resources for learning Factor. Lastly and maybe leastly, -* The [Concatenative Wiki][concatenative-wiki]. Note that while it has good content and it's not wrong by any means, it's not really updated and [is being phased out][phasing-out] in favour of the GitHub Wiki above. - * [Stack Overflow][stack-overflow]. There's not a large community (okay, about three users including yours truly) but ask there if you're really, truly stuck and someone will surely help you out. * The [Mailing List][mailing-list]. Here, you can ask about anything Factor-related and a collaborator will answer helpfully. @@ -40,8 +36,6 @@ Finally, Factor is written almost entirely in Factor. So, read the source code, [rosetta-code]: https://rosettacode.org/wiki/Rosetta_Code [chrestomathy]: https://en.wikipedia.org/wiki/Chrestomathy [rosetta-code-factor]: https://rosettacode.org/wiki/Category:Factor -[concatenative-wiki]: https://concatenative.org/wiki/view/Factor -[phasing-out]: https://github.com/factor/factor/issues/706 [stack-overflow]: https://stackoverflow.com/questions/tagged/factor-lang [mailing-list]: https://concatenative.org/wiki/view/Factor/Mailing%20list [irc-channel]: https://concatenative.org/wiki/view/Concatenative%20IRC%20channel diff --git a/docs/RESOURCES.md b/docs/RESOURCES.md index d9b0341c..a5e2503d 100644 --- a/docs/RESOURCES.md +++ b/docs/RESOURCES.md @@ -4,7 +4,6 @@ * [Andrea Ferretti's Factor tutorial][ferretti-tutorial]. * "[Factor in 2022][factor-in-2022]", a talk by John Benediktsson and Doug Coleman. * *[Thinking Forth][thinking-forth]* by Leo Brodie — on the concatenative, stack-oriented mindset. -* The [Factor GitHub Repository Wiki][github-wiki]. * [Björn Lindqvist's Factor Playground][playground-factor]. * [Learn X in Y Minutes, where X = Factor][learn-x-in-y-minutes]. * [Factor on RosettaCode][rosetta-code]. @@ -21,7 +20,6 @@ [ferretti-tutorial]: https://andreaferretti.github.io/factor-tutorial/ [factor-in-2022]: https://www.youtube.com/watch?v=OLh61q4c4XE [thinking-forth]: https://thinking-forth.sourceforge.net/ -[github-wiki]: https://github.com/factor/factor/wiki [playground-factor]: https://github.com/bjourne/playground-factor [learn-x-in-y-minutes]: https://learnxinyminutes.com/docs/factor [rosetta-code]: https://rosettacode.org/wiki/Category:Factor diff --git a/docs/TESTS.md b/docs/TESTS.md index be2b8c2a..b183a293 100644 --- a/docs/TESTS.md +++ b/docs/TESTS.md @@ -22,10 +22,10 @@ The Factor track uses **Factor 0.101**. Each exercise ships with a small bundled factor -roots=. -run=exercism-tools ``` -For example, to run the `annalyns-infiltration` tests: +For example, to run the `hello-world` tests: ``` -factor -roots=. -run=exercism-tools annalyns-infiltration +factor -roots=. -run=exercism-tools hello-world ``` The runner exits with status 0 when all tests pass, and non-zero with diagnostic output when any test fails. diff --git a/exercises/shared/.docs/help.md b/exercises/shared/.docs/help.md index 6add74d0..3994c660 100644 --- a/exercises/shared/.docs/help.md +++ b/exercises/shared/.docs/help.md @@ -10,10 +10,10 @@ run from this exercise's directory: factor -roots=. -run=exercism-tools ``` -For example, for `annalyns-infiltration`: +For example, for `hello-world`: ``` -factor -roots=. -run=exercism-tools annalyns-infiltration +factor -roots=. -run=exercism-tools hello-world ``` Each exercise ships a small bundled `exercism-tools` vocabulary @@ -49,7 +49,7 @@ exercism submit /.factor For example: ``` -exercism submit annalyns-infiltration/annalyns-infiltration.factor +exercism submit hello-world/hello-world.factor ``` If the exercise's `.meta/config.json` lists more than one @@ -69,8 +69,7 @@ mentor feedback on whatever you have so far. is the best place for track-specific questions and feedback. - The [Exercism Discord](https://exercism.org/r/discord) has channels for both general help and individual tracks. -- [Factor's official documentation](https://docs.factorcode.org/) - is searchable and exhaustive. Two good entry points: +- Factor's official documentation is searchable and exhaustive. Two good entry points: - [The Factor handbook](https://docs.factorcode.org/content/article-handbook.html) — reference-style, organised by vocabulary. - [The Factor cookbook](https://docs.factorcode.org/content/article-cookbook.html) diff --git a/exercises/shared/.docs/tests.md b/exercises/shared/.docs/tests.md index ee850916..5106363e 100644 --- a/exercises/shared/.docs/tests.md +++ b/exercises/shared/.docs/tests.md @@ -6,10 +6,10 @@ The Factor track uses **Factor 0.101**. Each exercise ships with a bundled `exer factor -roots=. -run=exercism-tools ``` -For example, for the `annalyns-infiltration` exercise: +For example, for the `hello-world` exercise: ``` -factor -roots=. -run=exercism-tools annalyns-infiltration +factor -roots=. -run=exercism-tools hello-world ``` The runner exits with status 0 when all tests pass, and non-zero with diagnostic output when any test fails.