Commit Graph

31 Commits

Author SHA1 Message Date
Stephen A. Wilson e10c75aebf Remove duplicated docs
Signed-off-by: Stephen A. Wilson <code@stephenawilson.ca>
2024-06-22 15:55:40 -04:00
Stephen A. Wilson 605b6916cf Allow for searching TechDocs by Title
Signed-off-by: Stephen A. Wilson <code@stephenawilson.ca>
2024-06-13 11:08:03 -04:00
Patrick Jungermann 05f584f84d feat: add documented component to uffizzi environment
So far, none of the components at the uffizzi environment have techdocs.
Hence, there are no docs available within this environment
and related features are not covered.

This change will add an example from techdocs-backend plugin
to the deployed examples.

It was possible to register this catalog file manually,
however the build of the docs fail due to missing Docker.

To allow the generation of docs, we use the local generator
(no docker in docker) and install required dependencies.

As we don't want all dependencies for all (default) extensions
to be installed at this environment, the original example at
techdocs-backend plugin was copied and reduced
(PlantUML extension example was removed).

Signed-off-by: Patrick Jungermann <Patrick.Jungermann@gmail.com>
2023-05-12 12:03:46 +02:00
Patrik Oldsberg e5a9031eae microsite-next: redirects for new index pages + fix links
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2023-03-06 11:46:11 +01:00
Fredrik Adelöw 2a6d762539 just some vale fixes
Signed-off-by: Fredrik Adelöw <freben@gmail.com>
2022-10-11 13:10:48 +01:00
Camila Belo 4c09c09102 refactor(techdocs): apply review suggestions
Signed-off-by: Camila Belo <camilaibs@gmail.com>
2022-06-23 13:35:01 +02:00
Eric Peterson b90722229b Replace <Example* /> examples in app with <GiveFeedbackAddon /> (and add repo/edit for fixture docs sites).
Co-authored-by: Anders Näsman <andersn@spotify.com>
Signed-off-by: Eric Peterson <ericpeterson@spotify.com>
2022-04-11 12:05:05 +02:00
Eric Peterson 742434a6ba Fix TechDocs download bug when backend/app hosts are the same.
Signed-off-by: Eric Peterson <ericpeterson@spotify.com>
2022-02-01 13:39:23 +01:00
Emma Indal 156421c59a [TechDocs] Update default techdocs docker image to latest version (#7448)
* set default docker image to latest one 0.3.3

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* update extensions docs with new truly sane lists example

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* changeset

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* use consistent tagging for docker image versions

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* update changeset with correct link to tag

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* update api report

Signed-off-by: Emma Indal <emma.indahl@gmail.com>
2021-10-05 13:57:55 +02:00
Aurelio Saraiva ce02607532 added title
Signed-off-by: Aurelio Saraiva <aureliosaraiva@gmail.com>
2021-08-18 19:02:04 -03:00
Eric Peterson 602b1e5c97 Update scaffolder templates to use the new, recommended annotation value.
Signed-off-by: Eric Peterson <ericpeterson@spotify.com>
2021-07-28 18:43:49 +02:00
Fredrik Adelöw b99ac3f6e1 Minor composability etc docs changes
Signed-off-by: Fredrik Adelöw <freben@gmail.com>
2021-05-02 22:13:05 +02:00
Oliver Sand 21cc2f9216 Different workaround for prettier issue with markdown files
Follow up for #5073

Instead of disabling prettier completely, I would prefer to disable it for the lines that actual cause issues.

Signed-off-by: Oliver Sand <oliver.sand@sda-se.com>
2021-03-24 19:28:32 +01:00
Oliver Sand 1b42444587 Fix indentions of admonitions (#5073)
Signed-off-by: Oliver Sand <oliver.sand@sda-se.com>
2021-03-23 21:29:31 +01:00
Adam Harvey 9b3a205303 PIP8 alignment
Signed-off-by: Adam Harvey <adam.harvey@dxc.com>
2021-03-17 11:23:08 -04:00
Adam Harvey 2ef9ac9d83 Change wording for spelling alignment
Signed-off-by: Adam Harvey <adam.harvey@dxc.com>
2021-03-16 22:58:47 -04:00
Adam Harvey 8efa047a6b Wrap lines
Signed-off-by: Adam Harvey <adam.harvey@dxc.com>
2021-03-16 22:50:12 -04:00
Adam Harvey 74e0e12e41 Update text
Signed-off-by: Adam Harvey <adam.harvey@dxc.com>
2021-03-16 22:48:59 -04:00
Adam Harvey 70d96002ac Update example documentation
Signed-off-by: Adam Harvey <adam.harvey@dxc.com>
2021-03-16 22:38:33 -04:00
Emma Indal c8b54c3702 TechDocs Homepage (#4401)
* add tabs to homepage

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* add new overview content component

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* add new owned content component

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* add types

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* add test for owned content component

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* add test for overview content

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* document name to link and change copy to clipboard link

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* add changeset

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* rename changeset file

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* fix types

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* move home components out from reader dir to its own dir

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* Update plugins/techdocs/src/reader/components/OverviewContent.tsx

Co-authored-by: Himanshu Mishra <himanshu@orkohunter.net>
Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* enable search in table

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* add docs icon to core icons

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* add example TechDocs support button config

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* use isOwnerOff and useOwnUser to see documents that are owned via group membership

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* update tests

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* cleanup imports

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* leave techdocs support config out of this PR

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* prettieeeeeer

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* copy paste useOwnUser hook over to techdocs plugin

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* add changeset

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

* delete unused package

Signed-off-by: Emma Indal <emma.indahl@gmail.com>

Co-authored-by: Himanshu Mishra <himanshu@orkohunter.net>
2021-03-11 19:23:32 +01:00
Adam Harvey a9d7c123fb Wording tweaks
Signed-off-by: Adam Harvey <adam.harvey@dxc.com>
2021-03-04 18:53:39 -05:00
Adam Harvey 2daa65a18b Change wording
Signed-off-by: Adam Harvey <adam.harvey@dxc.com>
2021-03-04 18:51:57 -05:00
Adam Harvey c149b14009 Fix typo
Signed-off-by: Adam Harvey <adam.harvey@dxc.com>
2021-03-04 18:51:34 -05:00
Adam Harvey 02d78290a5 Enhance example documented-component
Signed-off-by: Adam Harvey <adam.harvey@dxc.com>
2021-03-04 16:05:17 -05:00
Himanshu Mishra dc33c51890 TechDocs: Use URL Reader in the out-of-the-box experience
It is time to start using URL Reader for the exmaple docs components we provide in the out-of-the-box experience (i.e. when users experience TechDocs by doing a git clone of this repository).

URL Reader makes the prepare step 8x faster.
2021-01-13 21:38:26 +01:00
Patrik Oldsberg af141c0766 rewrite repo location urls 2020-11-03 11:03:49 +01:00
Sebastian Qvarfordt 613c06bdd6 Techdocs: Updates preparers to make it work in actual usecases (#1957)
* feature(techdocs): JIT generation of techdocs

* Fix linting issues

* Add Techdocs tab to entity page

* Added missing dep

* Added missing dep

* Removed duplicate dep

* Better tab navigation

* Update label on entity page to say docs

* Fix lint issue

* Move building of docs from entity to a function

* feature(techdocs): JIT generation of techdocs

* Fix linting issues

* Add Techdocs tab to entity page

* Added missing dep

* Added missing dep

* Removed duplicate dep

* Better tab navigation

* Update label on entity page to say docs

* Fix lint issue

* Move building of docs from entity to a function

* attempt to add back react as a dep

* Fixed failing test

* fix(techdocs): Hopefully fixed tests

* Fixed another failing test

* Initial apiRef for techdocs storage

* Cleaned up some code in reader

* test(headertabs): add tests to HeaderTabs component

* fix(headertabs): change tab mock id

* fix(techdocs-generator): fix problem with macOS symlink to tmp folder

* fix(lint): remove unused configApiRef

* wip

* Ongoing cleanups

* Cleanups and fix tests

* Initial github preparer. Doesn't work properly yet

* Updated dir preparer to handle github managed-by-location and added github preparer

* Removed old file

* Fixed feedback and added better logging to techdocs build process

* Updated create-app template

Co-authored-by: Fredrik Adelöw <freben@gmail.com>
Co-authored-by: Emma Indal <emmai@spotify.com>
2020-08-21 12:11:03 +02:00
Sebastian Qvarfordt 13908d69c2 TechDocs: Access entity techdocs from service catalog (#1835)
* feature(techdocs): JIT generation of techdocs

* Fix linting issues

* Add Techdocs tab to entity page

* Added missing dep

* Added missing dep

* Removed duplicate dep

* Better tab navigation

* Update label on entity page to say docs

* Fix lint issue

* Move building of docs from entity to a function

* feature(techdocs): JIT generation of techdocs

* Fix linting issues

* Add Techdocs tab to entity page

* Added missing dep

* Added missing dep

* Removed duplicate dep

* Better tab navigation

* Update label on entity page to say docs

* Fix lint issue

* Move building of docs from entity to a function

* attempt to add back react as a dep

* Fixed failing test

* fix(techdocs): Hopefully fixed tests

* Fixed another failing test

* Initial apiRef for techdocs storage

* Cleaned up some code in reader

* test(headertabs): add tests to HeaderTabs component

* fix(headertabs): change tab mock id

* fix(techdocs-generator): fix problem with macOS symlink to tmp folder

* fix(lint): remove unused configApiRef

* wip

* Ongoing cleanups

* Cleanups and fix tests

* WIP cleanups

* Clean up some things

* Clean up some things

* Added missing notice header

* ts issue fixed

* Add show contition to api tab

Co-authored-by: Fredrik Adelöw <freben@gmail.com>
Co-authored-by: Emma Indal <emmai@spotify.com>
2020-08-20 14:06:09 +02:00
Sebastian Qvarfordt 7808c115d1 Added empty line at the end of file 2020-07-23 14:28:50 +02:00
Sebastian Qvarfordt 851b040c41 changed spotify.com namespace to backstage.io 2020-07-23 14:14:30 +02:00
Sebastian Qvarfordt 9e2606a89a feature(techdocs): added an example component in techdocs-backend containing a documentation reference 2020-07-22 16:44:14 +02:00