Skip to content
GitLab
Explore
Sign in
Primary navigation
Search or go to…
Project
Standard
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Iterations
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Locked files
Build
Pipelines
Jobs
Pipeline schedules
Test cases
Artifacts
Deploy
Releases
Model registry
Monitor
Service Desk
Analyze
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
MTS
TTCN-3
Standard
Commits
aa26d046
Commit
aa26d046
authored
6 months ago
by
Matthias Simon
Browse files
Options
Downloads
Patches
Plain Diff
Add change request SOP
parent
c173df17
No related branches found
No related tags found
No related merge requests found
Pipeline
#9444
passed
6 months ago
Stage: build
Stage: test
Stage: deploy
Changes
1
Pipelines
2
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
docs/how-to-make-a-change-request.md
+85
-0
85 additions, 0 deletions
docs/how-to-make-a-change-request.md
with
85 additions
and
0 deletions
docs/how-to-make-a-change-request.md
0 → 100644
+
85
−
0
View file @
aa26d046
# How to make a change request?
## Purpose
This document describes how to make a change request for the TTCN-3 standard.
Change requests are the basis for managing changes and tracking discussions on
the standard.
When this procedure is followed correctly:
-
Change requests will contain all the necessary information.
-
Change requests will be actionable.
-
Discussions, progress and decisions on the change request will be tracked.
When this procedure is not followed:
-
Change requests may be incomplete or unclear.
-
Duplicate change requests may be created.
-
Change requests might be rejected due to lack of information.
## Procedure
**Inputs:**
-
An EOL or an individual account.
1.
**[Sign in](https://labs.etsi.org/rep/users/sign_in)**
: Use your EOL account
(same credentials as in the ETSI portal) or individual account to sign in.
2.
**Assure your request have not been made before:**
Navigate to our
[
issue
tracker
](
https://labs.etsi.org/rep/mts/ttcn3/standard/-/issues/?sort=created_date&state=all&first_page_size=20#
)
and search for issues that match to your request. Make sure you search for all
issues, not only the open ones.
If your request has already been made, you can add a comment to the existing.
3.
**Open issue form**
: After you made sure, that your request have not been
made before, open the issue form by clicking on
[
"New
issue"
](
https://labs.etsi.org/rep/mts/ttcn3/standard/-/issues/new
)
.
4.
**Add title**
: Choose a title that describes your change request concisely.
Some good exampleis: "Proposal: Add Rust interface", "Typo in section
3.
2.1", "Clarify the definition of 'foo'", ...
5.
**Choose a description template**
": Choose a template from the dropdown box
that fits your change request most. !
[
issue
templates
](
assets/issue-templates.png
)
The templates will help you to
provide the necessary information and to structure your request efficiently.
You may add or remove parts of the template as needed.
6.
**Fill in the details**
": Describe your change request. GitLab specific
fields like "Assignee", "Milestone", "Labels" can be left empty.
If you have related or similar change requests, it is good practice to link
them in the description.
7.
**Add attachements**
: If you have additional files, like a document or
images that describe the change request in detail, you can attach it to the
issue.
**Outputs:**
-
An issue describing your change request is created.
## FAQs
**Where do I get an account?**
If you represent an ETSI member or ISG/SDG Participant organization, you can
request your EOL
[
here
](
https://webapp.etsi.org/createaccount/
)
.
If you don't represent any organization, you can create an Individual Account
with your personal email address
[
here
](
https://labs.etsi.org/signup/
)
.
**Which description template should I choose for my change request?**
Following templates are available:
The _Editorial Changes_ template is used for changes that do not affect
meaning of the standard. For example, fixing typos, grammar, or formatting.
_Clarification Needed_
is used when the standard is unclear or ambiguous. For
example, if a term is not defined, or if an enumeration is missing a value and
it is unclear if this is on purpose.
Create a _Bug Report_ if the standard does not specify TTCN-3 as intended. For
example, if two specifications contradict each other, or if an example does not
reflect defined behavior.
A _Feature proposal_ is used to suggest new features, interfaces, documents
or changes to existing ones.
You do not need to provide a full specification document, yet. It is practice
to discuss the proposal first and create the document when the proposal is
accepted and all details are clear.
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment