jambor.pro/docs-onboarding
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

new: Neuer Ansatz für FAQ beschrieben und Query erstellt.

Browse source
This commit is contained in:
Jan Jambor 2024-05-22 13:16:43 +02:00
parent e95731a7a9
commit 2fd9f69d47
1 changed files with 9 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

10
faq.md
View file

@ -1,3 +1,11 @@
# Frequently Asked Questions
Suggestion JJ: Frequently asked questions by new developers. Here we display a link to a shared query displaying all work items of type task tagged with `FAQ`. The goal of doing so is, that we don't want to maintain a rather static markdown file and we want to be able to link FAQ entries to eg. Bug work items, meeting notes and so on.
Frequently asked questions can arise from various sources. Typically, you are working on a story or a bug and you want to preserve your findings for future reference. In such a case, you can simply add a tag `FAQ` to the work item. Then the shared query [FAQ Work Items](https://xwr.visualstudio.com/jambor.pro/_queries/query/3007dd06-8f69-48ed-bba8-57e0a64a84f4/) will display all work items tagged with `FAQ`. This way, you can easily share your findings with other team members and find them later. If you have a finding outside of working on a story or bug, you can simply create a new work item of type task and tag it with `FAQ`.
Link to the shared query: [FAQ Work Items](https://dev.azure.com/ypsag/IT/_queries/query/4911db3a-27e1-467f-982e-b5498b7241ff/)
This approach does not change the process for handling the work item. You still close the story or bug when it is completed.
If an FAQ is no longer relevant, you can simply remove the tag `FAQ` from the work item.
The shared query is created quite simply: include work items from all projects that include the tag `FAQ`.