Swagger Editor and Gitlab - Revision history

Carignani at 16:30, 5 November 2018

2018-11-05T16:30:41Z

← Older revision		Revision as of 18:30, 5 November 2018
Line 1:		Line 1:
	{{Warning\|this tool is in Alpha version.}}		{{Warning\|this tool is in Alpha version.}}

			== What is this? ==
			<big>To help ETSI Groups working over OpenAPIs in a smooth and efficient way, this tool integrates the well known Swagger Editor with the repository management system at ETSI Forge, namely Gitlab.</big>

			<big>This modified version of the tool let's '''the user log into Gitlab and automatically import OpenAPIs from the user's repositories and the branches within'''.</big>
			[[File:Swagger-editor-gitlab.png\|center\|frameless\|593x593px]]

			<big>'''Important''': the file needs to be already in the project and in the correct branch.</big>

			<big>After editing, the user may save back the results into the project.</big>

	== Try it yourself ==		== Try it yourself ==

Carignani at 16:24, 5 November 2018

2018-11-05T16:24:28Z

← Older revision		Revision as of 18:24, 5 November 2018
Line 5:		Line 5:
	[https://forge.etsi.org/swagger/editor-versions/v2.10.4-1 <big>'''---> Click here <---'''</big>]		[https://forge.etsi.org/swagger/editor-versions/v2.10.4-1 <big>'''---> Click here <---'''</big>]

	== ~~1. Log in with Gitlab~~ ==		== Usage ==
	* Click File -> Log into Gitlab
	* Click Log into Gitlab in the model
	~~You will be redirected to Gitlab login or, if you have already accessed, the page will simply reload.~~

	== 2. ~~Import a YAML/JSON file from a project~~ ==		=== 1. Log in with Gitlab ===
	* Click File -> ~~Import from~~ Gitlab		* <big>Click File -> Log into Gitlab</big>
	* You will ~~need~~ to ~~select a project (among the ones~~ you have ~~access to)~~		* <big>Click Log into Gitlab in the model</big>
	** If the list is empty please wait a few seconds or close the box and re-open it		<big>You will be redirected to Gitlab login or, if you have already accessed, the page will simply reload.</big>
	* Select the ~~branch (this branch~~ will ~~be used for the commit operation as well!)~~
	*

	== 3. ~~Save the~~ file ~~in the repository~~ ==		=== 2. Import a YAML/JSON file from a project ===
			* <big>Click File -> Import from Gitlab</big>
			* <big>You will need to select a project (among the ones you have access to)</big>
			** <big>If the list is empty please wait a few seconds or close the box and re-open it</big>
			* <big>Select the branch (this branch will be used for the commit operation as well!)</big>

	== 4. Log out of Gitlab ==		=== 3. Save the file in the repository ===
			* Click File -> Submit to Gitlab
			* Insert a description for your change. It will be used as Commit Message in the repository.
			That's all!

			=== 4. Log out of Gitlab ===
			* Click File -> Log out from Gitlab

Carignani at 16:19, 5 November 2018

2018-11-05T16:19:56Z

← Older revision		Revision as of 18:19, 5 November 2018
Line 1:		Line 1:
	Warning: this ~~tools~~ is in Alpha version.		{{Warning\|this tool is in Alpha version.}}

	== Try it yourself ==		== Try it yourself ==

Carignani at 12:17, 26 October 2018

2018-10-26T12:17:12Z

← Older revision		Revision as of 14:17, 26 October 2018
Line 3:		Line 3:
	== Try it yourself ==		== Try it yourself ==

	[https://forge.etsi.org/swagger/editor-versions/v2.10.4-1 Click here]		[https://forge.etsi.org/swagger/editor-versions/v2.10.4-1 <big>'''---> Click here <---'''</big>]

	== 1. Log in with Gitlab ==		== 1. Log in with Gitlab ==
			* Click File -> Log into Gitlab
			* Click Log into Gitlab in the model
			You will be redirected to Gitlab login or, if you have already accessed, the page will simply reload.

	== 2. Import a YAML/JSON file from a project ==		== 2. Import a YAML/JSON file from a project ==
			* Click File -> Import from Gitlab
			* You will need to select a project (among the ones you have access to)
			** If the list is empty please wait a few seconds or close the box and re-open it
			* Select the branch (this branch will be used for the commit operation as well!)
			*

	== 3. Save the file in the repository ==		== 3. Save the file in the repository ==

	== 4. Log out of Gitlab ==		== 4. Log out of Gitlab ==

Carignani: Created page with "Warning: this tools is in Alpha version. == Try it yourself == [https://forge.etsi.org/swagger/editor-versions/v2.10.4-1 Click here] == 1. Log in with Gitlab == == 2. Impo..."

2018-10-26T12:12:12Z

Created page with "Warning: this tools is in Alpha version. == Try it yourself == [https://forge.etsi.org/swagger/editor-versions/v2.10.4-1 Click here] == 1. Log in with Gitlab == == 2. Impo..."

New page

Warning: this tools is in Alpha version.

== Try it yourself ==

[https://forge.etsi.org/swagger/editor-versions/v2.10.4-1 Click here]

== 1. Log in with Gitlab ==

== 2. Import a YAML/JSON file from a project ==

== 3. Save the file in the repository ==

== 4. Log out of Gitlab ==