Commit Graph

141 Commits

Author SHA1 Message Date
Tim 4e1227ce2e Merge pull request #5032 from backstage/timbonicus/create-app-updates
Update create-app template for better parity with example app
2021-03-25 06:23:36 -06:00
Patrik Oldsberg ce560648b3 Merge pull request #5052 from maikelvl/patch-1
Fix docs on Helm install commands.
2021-03-24 22:02:31 +01:00
Adam Harvey 7cb67326c4 Apply feedback
Signed-off-by: Adam Harvey <adam.harvey@dxc.com>
2021-03-24 14:52:49 -04:00
Adam Harvey 3846a67f04 Fix typo
Signed-off-by: Adam Harvey <adam.harvey@dxc.com>
2021-03-24 14:35:48 -04:00
Adam Harvey 1f2bdb81c4 Add Key Concepts page
Signed-off-by: Adam Harvey <adam.harvey@dxc.com>
2021-03-24 14:31:15 -04:00
Adam Harvey aa9bcba113 Clarify contributing
Signed-off-by: Adam Harvey <adam.harvey@dxc.com>
2021-03-24 14:31:00 -04:00
Maikel 628e7382ec Fix docs on Helm install commands.
Signed-off-by: Maikel Vlasman <github-82jnd5llq8fji7v5@maikelvlasman.com>
2021-03-22 14:16:30 +01:00
Tim Hansen f88fe9dd9b Update create-app template for better parity with example app
Fixes #4613

Signed-off-by: Tim Hansen <timbonicus@gmail.com>
2021-03-19 15:18:26 -06:00
Patrik Oldsberg 4c80c7203a docs: differentiating detailed docker deployment documentation descriptions
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2021-03-18 19:51:49 +01:00
Ben Lambert b028502c2d Merge pull request #4826 from backstage/timbonicus/keep-updated
Move the keeping-updated topic to getting-started
2021-03-09 16:50:43 +01:00
Adam Harvey b636f3031b Update getting started for yarn dev
Signed-off-by: Adam Harvey <adam.harvey@dxc.com>
2021-03-08 14:46:00 -05:00
Tim Hansen bae135c88e Merge branch 'master' into timbonicus/keep-updated 2021-03-08 08:06:16 -07:00
Tim Hansen 2369c72cac Update words, add versions:check section
Signed-off-by: Tim Hansen <timbonicus@gmail.com>
2021-03-05 09:31:36 -07:00
Tim Hansen c694e47360 Move the keeping-updated topic to getting-started
Signed-off-by: Tim Hansen <timbonicus@gmail.com>
2021-03-04 19:45:12 -07:00
Tim Hansen b17819246c Add note about monorepo
Signed-off-by: Tim Hansen <timbonicush@spotify.com>
2021-03-04 11:58:20 -07:00
Tim Hansen ffdae9be17 Update documentation, remove CircleCI from default app
Signed-off-by: Tim Hansen <timbonicush@spotify.com>
2021-03-03 15:38:50 -07:00
Tim Hansen 64615dd726 Fix relative link 2021-03-01 14:52:55 -07:00
Tim Hansen cdd6d1db7c docs: Improve flow for getting-started docs 2021-03-01 14:33:29 -07:00
Patrik Oldsberg 4097031e6a Update docs/getting-started/contributors.md
Co-authored-by: Adam Harvey <adam.harvey@dxc.com>
2021-02-25 22:27:04 +01:00
Patrik Oldsberg 3bc7365bbc docs: added note about marking frontend config visible 2021-02-25 18:40:40 +01:00
Olle Lundberg 79f7461709 Recommend a safer find command
Piping find to xargs is dangerous as xargs will interpret any characters
defined in $IFS (Input Field Separator), usually <space><tab><newline>,
as separators in its input. This might lead to unintented operations
on files if any of the input to xargs containts any of the characters
defined in $IFS, most often this happens if a file contains a space in
its name. The safest way to execute a find | xargs is to force find to
separate its output with null characters and tell xargs to read null
characters as the delimiter AND also tell xargs to put the argument to
the command its supposed to run in quotation marks:
   `find ... -print0 | xargs -I {} -0 rm -rf "{}"`
When running with GNU find you most likely also want to add
--no-run-if-empty or -r for short:
   `find ... -print0 | xargs -I {} -0 --no-run-if-empty rm -rf "{}"`
This stops the invocation of xargs if there is no input on stdin, this
is however not portable and will break on BSD/macOS, the portability is
not a concern in this case though as the find | xargs happens in docker.

As you can see this gets unwieldly fast and despite using every
precaution, it's still not safe. When xargs is run with -0 to treat null
characters as the delimiter for its input and a file has a null
character in its name, xargs will treat the null character in the file
name as a delimiter and xargs will exhibit the same behaviour as it did
with spaces in file names.

Ahhh, isn't Unix wonderful? Loose APIs defined as untyped strings...

There is a salvation though! Most find xargs pipes are unnecessary and
can be replaced with built in functionality in find, the -exec flag.
Now, -exec comes in 2 flavours, one that is terminated with \; (the most
commonly used) and one terminated with \+ (the one most people actually
want to use). \; spawns a new invocation per found entry, thus creating
some process creation overhead. \+ instead concatenates the found
entries as arguments to the program we want to run, resulting in less
overhead and usually a faster execution.
Since find is smart enough to be aware of what constitutes an entry
(i.e it doesn't treat the entries as just a bunch of random strings to
read from stdin) it makes the whole invocation of the program, rm in
this case, safe even if it contains characters defines in $IFS or null
characters.

And with this overly elaborate commit message I bring you this 1 line
change.
2021-02-19 09:57:32 +01:00
Patrik Oldsberg 021c70d673 Merge pull request #4564 from backstage/rugvip/docker-builds
docker: switch to backend:bundle + update docs with both host and multi-stage build
2021-02-18 11:01:47 +01:00
Patrik Oldsberg 38fe527d97 dockerfile: mention build-image command 2021-02-17 21:23:12 +01:00
Patrik Oldsberg 40f0c33378 update backend Dockerfile to use config example and fix comment 2021-02-17 20:44:40 +01:00
Patrik Oldsberg d13aea9cd2 docs: add full docker deployment docs 2021-02-17 20:44:10 +01:00
blam d7abf2a2db chore: fix some other wording 2021-02-16 15:19:31 +01:00
blam 687ddc49d7 chore: reworking the title of the docs to avoid confusion 2021-02-12 23:50:03 +01:00
blam cbf4566ed6 docs: rework the getting started documentation for both contributors and integraters are seperated 2021-02-12 23:31:55 +01:00
Alex C. Bilimoria 0009804a84 Update docker run command in deployment-other.md 2021-02-04 09:58:41 -07:00
Adam Harvey e763dcf8c4 Fix Backstage case 2021-01-29 14:17:09 -05:00
blam 1f675381a9 chore: fixing vale stuff 2021-01-27 21:59:44 +01:00
blam e9b9fa2ffe chore: added a note about .dockerignore 2021-01-27 16:38:27 +01:00
blam 8080d1ef4f chore: change the wording slightly 2021-01-26 17:39:28 +01:00
blam 2dee00292c chore: review comments 2021-01-26 17:34:52 +01:00
blam 6cc06d4e7f chore: fixing spelling of docs 2021-01-26 15:56:33 +01:00
blam ad52b78b8d chore: reworking the files so that it's moved to docs instea 2021-01-26 15:55:34 +01:00
Patrik Oldsberg f5cc804ca3 docs: add docs for how to handle type checking issues with linked in packages 2021-01-16 15:44:40 +01:00
Fredrik Adelöw ffa36ff101 Merge pull request #3927 from adamdmharvey/doco-prettier-seo
docs: Align Docusaurus for fixed SEO output and "prettier" happiness
2021-01-12 21:42:53 +01:00
Himanshu Mishra 7712795f9b docs: add port to url 2021-01-12 17:46:24 +01:00
Adam Harvey 14466940f7 Single line metadata and prettier ignore 2021-01-05 13:42:31 -05:00
Frieder Bluemle cbd3a44c09 Fix typos (#3646) 2020-12-09 07:50:41 +01:00
Stefan Ålund 0ebfc75b41 Fix docs 2020-11-26 20:50:32 +01:00
Stefan Ålund 63998e65b1 Update docs/getting-started/configure-app-with-plugins.md
Co-authored-by: Fredrik Adelöw <freben@gmail.com>
2020-11-26 20:27:10 +01:00
Stefan Ålund 276a9e5919 Update docs/getting-started/configure-app-with-plugins.md
Co-authored-by: Fredrik Adelöw <freben@gmail.com>
2020-11-26 20:27:02 +01:00
Stefan Ålund 05b54d8b17 Update docs/getting-started/configure-app-with-plugins.md
Co-authored-by: Fredrik Adelöw <freben@gmail.com>
2020-11-26 20:26:53 +01:00
Stefan Ålund a00c393b38 Add API docs plugin to new apps 2020-11-26 14:20:47 +01:00
Kevin Kelly ed08863e17 docs: create an app, node version update 2020-11-21 23:48:36 -05:00
Kevin Kelly 031ead5f5a docs: update local install example for node v14 2020-11-21 23:33:32 -05:00
Patrik Oldsberg 206dce0bf8 docs/create-app: document external package linking 2020-11-20 11:42:08 +01:00
David Tuite eecf08e3f7 Update Node LTS in Getting Started docs (#3254)
I've tested and the v14 [Fermium LTS](https://nodejs.org/en/about/releases/) works fine.
2020-11-06 00:32:13 +01:00