WEAT - Revision history

Peterb at 21:37, 6 April 2024

2024-04-06T21:37:11Z

← Older revision		Revision as of 21:37, 6 April 2024
Line 1:		Line 1:
	The '''Worked Example Authoring Tool (WEAT)''' is an innovative tool designed to facilitate the creation of worked examples for programming education through a ''human-AI collaboration'' approach. By integrating ChatGPT, WEAT assists instructors in generating line-by-line explanations for code examples in Java and Python. Instructors can provide the code and problem statement, and WEAT uses ChatGPT to generate explanations for each line of code. These explanations can then be reviewed, edited, and added into the worked examples, streamlining the process of creating educational programming materials.		The '''Worked Example Authoring Tool (WEAT)''' is an innovative tool designed to facilitate the creation of worked examples for programming education through a ''human-AI collaboration'' approach. By integrating ChatGPT, WEAT assists instructors in generating line-by-line explanations for code examples in Java and Python. Instructors can provide the code and problem statement, and WEAT uses ChatGPT to generate explanations for each line of code. These explanations can then be reviewed, edited, and added into the worked examples, streamlining the process of creating educational programming materials.

	===Try WEAT===		== Try WEAT ==

	[http://adapt2.sis.pitt.edu/pcex-authoring/ <u>Click here</u>] to access the '''WEAT''', use your account credentials and login into the tool or create an account if you don't have one (''please send an email to Mohammad Hassany [[mailto:moh70@pitt.edu moh70@pitt.edu]] to activate your account'').		[http://adapt2.sis.pitt.edu/pcex-authoring/ <u>Click here</u>] to access the '''WEAT''', use your account credentials and login into the tool or create an account if you don't have one (''please send an email to Mohammad Hassany [[mailto:moh70@pitt.edu moh70@pitt.edu]] to activate your account'').
Line 7:		Line 7:
	Please [https://youtu.be/IOfA0Ql3Zq0 <u>watch this video tutorial</u>] or read the [[WEAT_Tutorial\|<u>user manual</u>]] to learn more about our tool.		Please [https://youtu.be/IOfA0Ql3Zq0 <u>watch this video tutorial</u>] or read the [[WEAT_Tutorial\|<u>user manual</u>]] to learn more about our tool.

	===WEAT Interface===		== WEAT Interface ==

	[[File:weat_image8.png\|768px]]		[[File:weat_image8.png\|768px]]
Line 13:		Line 13:
	Worked Example Authoring Tool: Hub Page.		Worked Example Authoring Tool: Hub Page.

	===Publications===		== Publications ==
	* Hassany, M., Brusilovsky, P., Ke, J., Akhuseyinoglu, K., and Lekshmi Narayanan, A. B. (2023) Authoring Worked Examples for Java Programming with Human-AI Collaboration, Report No. arXiv:2312.02105, arXiv.		* Hassany, M., Brusilovsky, P., Ke, J., Akhuseyinoglu, K., and Lekshmi Narayanan, A. B. (2023) Authoring Worked Examples for Java Programming with Human-AI Collaboration, Report No. arXiv:2312.02105, arXiv.
	* Hassany, M., Brusilovsky, P., Ke, J., Akhuseyinoglu, K., and Lekshmi Narayanan, A. B. (2024) Human-AI Co-Creation of Worked Examples for Programming Classes. In: Proceedings of 5th Workshop on Human-AI Co-Creation with Generative Models (HA-GEN 20224) at IUI 2024, Greenville, SC, USA, March 18, 2024.		* Hassany, M., Brusilovsky, P., Ke, J., Akhuseyinoglu, K., and Lekshmi Narayanan, A. B. (2024) Human-AI Co-Creation of Worked Examples for Programming Classes. In: Proceedings of 5th Workshop on Human-AI Co-Creation with Generative Models (HA-GEN 20224) at IUI 2024, Greenville, SC, USA, March 18, 2024.
	* Hassany, M., Brusilovsky, P., Ke, J., Akhuseyinoglu, K., and Lekshmi Narayanan, A. B. (2024) Authoring Worked Examples for Java Programming with Human-AI Collaboration. In: Proceedings of ACM/SIGAPP Symposium on Applied Computing, SAC 2024, Avila, Spain, April 8-12, 2024.		* Hassany, M., Brusilovsky, P., Ke, J., Akhuseyinoglu, K., and Lekshmi Narayanan, A. B. (2024) Authoring Worked Examples for Java Programming with Human-AI Collaboration. In: Proceedings of ACM/SIGAPP Symposium on Applied Computing, SAC 2024, Avila, Spain, April 8-12, 2024.

Peterb at 21:34, 6 April 2024

2024-04-06T21:34:50Z

← Older revision		Revision as of 21:34, 6 April 2024
Line 1:		Line 1:
	The '''Worked Example Authoring Tool (WEAT)''' is an innovative tool designed to facilitate the creation of worked examples for programming education through a ''human-AI collaboration'' approach. By integrating ChatGPT, WEAT assists instructors in generating line-by-line explanations for code examples in Java and Python. Instructors can provide the code and problem statement, and WEAT uses ChatGPT to generate explanations for each line of code. These explanations can then be reviewed, edited, and added into the worked examples, streamlining the process of creating educational programming materials.		The '''Worked Example Authoring Tool (WEAT)''' is an innovative tool designed to facilitate the creation of worked examples for programming education through a ''human-AI collaboration'' approach. By integrating ChatGPT, WEAT assists instructors in generating line-by-line explanations for code examples in Java and Python. Instructors can provide the code and problem statement, and WEAT uses ChatGPT to generate explanations for each line of code. These explanations can then be reviewed, edited, and added into the worked examples, streamlining the process of creating educational programming materials.

	==Try WEAT==		===Try WEAT===

	[http://adapt2.sis.pitt.edu/pcex-authoring/ <u>Click here</u>] to access the '''WEAT''', use your account credentials and login into the tool or create an account if you don't have one (''please send an email to Mohammad Hassany [[mailto:moh70@pitt.edu moh70@pitt.edu]] to activate your account'').		[http://adapt2.sis.pitt.edu/pcex-authoring/ <u>Click here</u>] to access the '''WEAT''', use your account credentials and login into the tool or create an account if you don't have one (''please send an email to Mohammad Hassany [[mailto:moh70@pitt.edu moh70@pitt.edu]] to activate your account'').
Line 7:		Line 7:
	Please [https://youtu.be/IOfA0Ql3Zq0 <u>watch this video tutorial</u>] or read the [[WEAT_Tutorial\|<u>user manual</u>]] to learn more about our tool.		Please [https://youtu.be/IOfA0Ql3Zq0 <u>watch this video tutorial</u>] or read the [[WEAT_Tutorial\|<u>user manual</u>]] to learn more about our tool.

	==WEAT Interface==		===WEAT Interface===

	[[File:weat_image8.png\|768px]]		[[File:weat_image8.png\|768px]]
Line 13:		Line 13:
	Worked Example Authoring Tool: Hub Page.		Worked Example Authoring Tool: Hub Page.

	== Publications ==		===Publications===
	* Hassany, M., Brusilovsky, P., Ke, J., Akhuseyinoglu, K., and Lekshmi Narayanan, A. B. (2023) Authoring Worked Examples for Java Programming with Human-AI Collaboration, Report No. arXiv:2312.02105, arXiv.		* Hassany, M., Brusilovsky, P., Ke, J., Akhuseyinoglu, K., and Lekshmi Narayanan, A. B. (2023) Authoring Worked Examples for Java Programming with Human-AI Collaboration, Report No. arXiv:2312.02105, arXiv.
	* Hassany, M., Brusilovsky, P., Ke, J., Akhuseyinoglu, K., and Lekshmi Narayanan, A. B. (2024) Human-AI Co-Creation of Worked Examples for Programming Classes. In: Proceedings of 5th Workshop on Human-AI Co-Creation with Generative Models (HA-GEN 20224) at IUI 2024, Greenville, SC, USA, March 18, 2024.		* Hassany, M., Brusilovsky, P., Ke, J., Akhuseyinoglu, K., and Lekshmi Narayanan, A. B. (2024) Human-AI Co-Creation of Worked Examples for Programming Classes. In: Proceedings of 5th Workshop on Human-AI Co-Creation with Generative Models (HA-GEN 20224) at IUI 2024, Greenville, SC, USA, March 18, 2024.
	* Hassany, M., Brusilovsky, P., Ke, J., Akhuseyinoglu, K., and Lekshmi Narayanan, A. B. (2024) Authoring Worked Examples for Java Programming with Human-AI Collaboration. In: Proceedings of ACM/SIGAPP Symposium on Applied Computing, SAC 2024, Avila, Spain, April 8-12, 2024.		* Hassany, M., Brusilovsky, P., Ke, J., Akhuseyinoglu, K., and Lekshmi Narayanan, A. B. (2024) Authoring Worked Examples for Java Programming with Human-AI Collaboration. In: Proceedings of ACM/SIGAPP Symposium on Applied Computing, SAC 2024, Avila, Spain, April 8-12, 2024.

Peterb at 21:33, 6 April 2024

2024-04-06T21:33:31Z

← Older revision		Revision as of 21:33, 6 April 2024
Line 1:		Line 1:
	The '''Worked Example Authoring Tool (WEAT)''' is an innovative tool designed to facilitate the creation of worked examples for programming education through a ''human-AI collaboration'' approach. By integrating ChatGPT, WEAT assists instructors in generating line-by-line explanations for code examples in Java and Python. Instructors can provide the code and problem statement, and WEAT uses ChatGPT to generate explanations for each line of code. These explanations can then be reviewed, edited, and added into the worked examples, streamlining the process of creating educational programming materials.		The '''Worked Example Authoring Tool (WEAT)''' is an innovative tool designed to facilitate the creation of worked examples for programming education through a ''human-AI collaboration'' approach. By integrating ChatGPT, WEAT assists instructors in generating line-by-line explanations for code examples in Java and Python. Instructors can provide the code and problem statement, and WEAT uses ChatGPT to generate explanations for each line of code. These explanations can then be reviewed, edited, and added into the worked examples, streamlining the process of creating educational programming materials.

	== Try WEAT ==		==Try WEAT==

	[http://adapt2.sis.pitt.edu/pcex-authoring/ <u>Click here</u>] to access the '''WEAT''', use your account credentials and login into the tool or create an account if you don't have one (''please send an email to Mohammad Hassany [[mailto:moh70@pitt.edu moh70@pitt.edu]] to activate your account'').		[http://adapt2.sis.pitt.edu/pcex-authoring/ <u>Click here</u>] to access the '''WEAT''', use your account credentials and login into the tool or create an account if you don't have one (''please send an email to Mohammad Hassany [[mailto:moh70@pitt.edu moh70@pitt.edu]] to activate your account'').

	Please [https://youtu.be/IOfA0Ql3Zq0 <u>watch this video tutorial</u>] or read the [[WEAT_Tutorial\|<u>user manual</u>]] to learn more about our tool.		Please [https://youtu.be/IOfA0Ql3Zq0 <u>watch this video tutorial</u>] or read the [[WEAT_Tutorial\|<u>user manual</u>]] to learn more about our tool.

			==WEAT Interface==

	[[File:weat_image8.png\|768px]]		[[File:weat_image8.png\|768px]]

Peterb at 21:30, 6 April 2024

2024-04-06T21:30:31Z

← Older revision		Revision as of 21:30, 6 April 2024
Line 1:		Line 1:
	The '''Worked Example Authoring Tool (WEAT)''' is an innovative tool designed to facilitate the creation of worked examples for programming education through a ''human-AI collaboration'' approach. By integrating ChatGPT, WEAT assists instructors in generating line-by-line explanations for code examples in Java and Python. Instructors can provide the code and problem statement, and WEAT uses ChatGPT to generate explanations for each line of code. These explanations can then be reviewed, edited, and added into the worked examples, streamlining the process of creating educational programming materials.		The '''Worked Example Authoring Tool (WEAT)''' is an innovative tool designed to facilitate the creation of worked examples for programming education through a ''human-AI collaboration'' approach. By integrating ChatGPT, WEAT assists instructors in generating line-by-line explanations for code examples in Java and Python. Instructors can provide the code and problem statement, and WEAT uses ChatGPT to generate explanations for each line of code. These explanations can then be reviewed, edited, and added into the worked examples, streamlining the process of creating educational programming materials.

			== Try WEAT ==

	[http://adapt2.sis.pitt.edu/pcex-authoring/ <u>Click here</u>] to access the '''WEAT''', use your account credentials and login into the tool or create an account if you don't have one (''please send an email to Mohammad Hassany [[mailto:moh70@pitt.edu moh70@pitt.edu]] to activate your account'').		[http://adapt2.sis.pitt.edu/pcex-authoring/ <u>Click here</u>] to access the '''WEAT''', use your account credentials and login into the tool or create an account if you don't have one (''please send an email to Mohammad Hassany [[mailto:moh70@pitt.edu moh70@pitt.edu]] to activate your account'').
Line 8:		Line 10:

	Worked Example Authoring Tool: Hub Page.		Worked Example Authoring Tool: Hub Page.

			== Publications ==
			* Hassany, M., Brusilovsky, P., Ke, J., Akhuseyinoglu, K., and Lekshmi Narayanan, A. B. (2023) Authoring Worked Examples for Java Programming with Human-AI Collaboration, Report No. arXiv:2312.02105, arXiv.
			* Hassany, M., Brusilovsky, P., Ke, J., Akhuseyinoglu, K., and Lekshmi Narayanan, A. B. (2024) Human-AI Co-Creation of Worked Examples for Programming Classes. In: Proceedings of 5th Workshop on Human-AI Co-Creation with Generative Models (HA-GEN 20224) at IUI 2024, Greenville, SC, USA, March 18, 2024.
			* Hassany, M., Brusilovsky, P., Ke, J., Akhuseyinoglu, K., and Lekshmi Narayanan, A. B. (2024) Authoring Worked Examples for Java Programming with Human-AI Collaboration. In: Proceedings of ACM/SIGAPP Symposium on Applied Computing, SAC 2024, Avila, Spain, April 8-12, 2024.

Mhassany at 14:31, 4 April 2024

2024-04-04T14:31:07Z

Show changes

Mhassany: changed image sizes

2024-04-02T04:45:25Z

changed image sizes

← Older revision		Revision as of 04:45, 2 April 2024
Line 11:		Line 11:
	After opening the [http://adapt2.sis.pitt.edu/pcex-authoring/ <u>PCEX Authoring Tool</u>] ([https://youtu.be/IOfA0Ql3Zq0 Video Tutorial]), you will land on the ''Hub'' page. Click '''Login''', provide your account credentials and login into the tool. Then you will be redirected back to the ''Hub'' page.		After opening the [http://adapt2.sis.pitt.edu/pcex-authoring/ <u>PCEX Authoring Tool</u>] ([https://youtu.be/IOfA0Ql3Zq0 Video Tutorial]), you will land on the ''Hub'' page. Click '''Login''', provide your account credentials and login into the tool. Then you will be redirected back to the ''Hub'' page.

	[[File:weat_image8.png\|~~936px~~]]		[[File:weat_image8.png\|768px]]

	Fig 1) PCEX Authoring Tool: Hub Page.		Fig 1) PCEX Authoring Tool: Hub Page.
Line 20:		Line 20:
	In the ''Hub'' page, click on the navbar, then click on "Sources" to navigate to ''Sources'' page.		In the ''Hub'' page, click on the navbar, then click on "Sources" to navigate to ''Sources'' page.

	[[File:weat_image21.png\|~~936px~~]]		[[File:weat_image21.png\|768px]]

	Fig 2) PCEX Authoring Tool: Hub Page - when user is logged in.		Fig 2) PCEX Authoring Tool: Hub Page - when user is logged in.
Line 26:		Line 26:
	This page contains the list of sources you have created. Click "'''New Source'''" to create a new source.		This page contains the list of sources you have created. Click "'''New Source'''" to create a new source.

	[[File:weat_image18.png\|~~936px~~]]		[[File:weat_image18.png\|768px]]

	Fig 3) PCEX Authoring Tool: List of defined sources.		Fig 3) PCEX Authoring Tool: List of defined sources.
Line 32:		Line 32:
	A source has a title, problem description, and line-by-line annotated source code. Problem description can have multilines. Each line in the source code can be annotated either by providing explanations for it and/or marked as blank line.		A source has a title, problem description, and line-by-line annotated source code. Problem description can have multilines. Each line in the source code can be annotated either by providing explanations for it and/or marked as blank line.

	[[File:weat_image23.png\|~~936px~~]]		[[File:weat_image23.png\|768px]]

	Fig 4) PCEX Authoring Tool: Creating a source (e.g: Hello World!).		Fig 4) PCEX Authoring Tool: Creating a source (e.g: Hello World!).
Line 38:		Line 38:
	In a PCEX challenge, a blank line creates a parson-style problem that can be filled by the student with available distractors (check Figure 5). A distractor can be defined in the "'''Distractors'''" section when creating or editing a source.		In a PCEX challenge, a blank line creates a parson-style problem that can be filled by the student with available distractors (check Figure 5). A distractor can be defined in the "'''Distractors'''" section when creating or editing a source.

	[[File:weat_image1.png\|~~936px~~]]		[[File:weat_image1.png\|768px]]

	Fig 5) PCEX Authoring Tool: A PCEX challenge preview.		Fig 5) PCEX Authoring Tool: A PCEX challenge preview.

	[[File:weat_image25.png\|~~936px~~]]		[[File:weat_image25.png\|768px]]

	Fig 6) PCEX Authoring Tool: Define distractors (bottom section) for blank lines.		Fig 6) PCEX Authoring Tool: Define distractors (bottom section) for blank lines.
Line 52:		Line 52:
	As described in the user interface, these explanations can be dragged by the bars into the Annotations panel to be used/added to the currently selected line (check Figure 8). By default, previously generated explanations for the currently selected line are shown; click the "'''show all lines'''" to show all generated explanations. In the history panel click on another date/time to load explanations specific to that generation session.		As described in the user interface, these explanations can be dragged by the bars into the Annotations panel to be used/added to the currently selected line (check Figure 8). By default, previously generated explanations for the currently selected line are shown; click the "'''show all lines'''" to show all generated explanations. In the history panel click on another date/time to load explanations specific to that generation session.

	[[File:weat_image26.jpg\|~~936px~~]]		[[File:weat_image26.jpg\|768px]]

	Fig 7) Source Editor: ChatGPT Generated-Explanations (History).		Fig 7) Source Editor: ChatGPT Generated-Explanations (History).

	[[File:weat_image22.png\|~~936px~~]]		[[File:weat_image22.png\|768px]]

	Fig 8) Source Editor: Dragging previously generated explanations from history into the Annotations panel.		Fig 8) Source Editor: Dragging previously generated explanations from history into the Annotations panel.
Line 64:		Line 64:
	In the Annotations panel, explanations can be dragged by the bars. Drag and drop an explanation on another explanation to change their order, or hold "'''alt'''" key while dropping to append/merge them together, or drop the explanation on to the red trash can area to remove it (you will be asked to confirm this action since it is irreversible).		In the Annotations panel, explanations can be dragged by the bars. Drag and drop an explanation on another explanation to change their order, or hold "'''alt'''" key while dropping to append/merge them together, or drop the explanation on to the red trash can area to remove it (you will be asked to confirm this action since it is irreversible).

	[[File:weat_image20.png\|~~936px~~]]		[[File:weat_image20.png\|768px]]

	Fig 9) Source Editor: Drag explanations to reorder, merge or remove.		Fig 9) Source Editor: Drag explanations to reorder, merge or remove.
Line 70:		Line 70:
	In case you want to merge, cut, copy, or delete multiple explanations, click on the [[File:weat_image12.png\|33x30px]] button to see more actions. Select explanations by clicking either the "'''Select'''" (to start the selection, then click on the[[File:weat_image15.png\|22x20px]]checkboxes next to explanations to select), or "'''Select all'''" to select all the explanations. Then you can cut, copy, and delete the selected explanations.		In case you want to merge, cut, copy, or delete multiple explanations, click on the [[File:weat_image12.png\|33x30px]] button to see more actions. Select explanations by clicking either the "'''Select'''" (to start the selection, then click on the[[File:weat_image15.png\|22x20px]]checkboxes next to explanations to select), or "'''Select all'''" to select all the explanations. Then you can cut, copy, and delete the selected explanations.

	[[File:weat_image19.png\|~~936px~~]]		[[File:weat_image19.png\|768px]]

	Fig 10) Source Editor: Annotations panel more actions.		Fig 10) Source Editor: Annotations panel more actions.
Line 79:		Line 79:
	This page contains the list of activities you have created. Click "'''New Activity'''" to create a new activity.		This page contains the list of activities you have created. Click "'''New Activity'''" to create a new activity.

	[[File:weat_image7.png\|~~936px~~]]		[[File:weat_image7.png\|768px]]

	Fig 11) PCEX Authoring Tool: List of defined activities.		Fig 11) PCEX Authoring Tool: List of defined activities.
Line 87:		Line 87:
	After creating/updating a source or activity, click the preview button to ensure the activity is processed (/cached) and can be previewed by students later.		After creating/updating a source or activity, click the preview button to ensure the activity is processed (/cached) and can be previewed by students later.

	[[File:weat_image16.png\|~~936px~~]]		[[File:weat_image16.png\|768px]]

	Fig 12) PCEX Authoring Tool: Creating an activity(e.g: HelloWorld!).		Fig 12) PCEX Authoring Tool: Creating an activity(e.g: HelloWorld!).
Line 96:		Line 96:
	This page lists all publicly shared activities by different authors. You can click on the title to preview the activity, or click the open-in-new-tab icon next to the title to open it in a new tab (this url can be embedded in an iframe within your tools)		This page lists all publicly shared activities by different authors. You can click on the title to preview the activity, or click the open-in-new-tab icon next to the title to open it in a new tab (this url can be embedded in an iframe within your tools)

	[[File:weat_image8.png\|~~936px~~]]		[[File:weat_image8.png\|768px]]

	Fig 13) PCEX Authoring Tool: Hub Page.		Fig 13) PCEX Authoring Tool: Hub Page.

	[[File:weat_image4.png\|~~936px~~]]		[[File:weat_image4.png\|768px]]

	Fig 14) PCEX Authoring Tool: Activity Preview.		Fig 14) PCEX Authoring Tool: Activity Preview.

Mhassany at 22:15, 1 April 2024

2024-04-01T22:15:39Z

← Older revision		Revision as of 22:15, 1 April 2024
Line 14:		Line 14:

	Fig 1) PCEX Authoring Tool: Hub Page.		Fig 1) PCEX Authoring Tool: Hub Page.

			<span id="sources"></span>
			= Sources =

	In the ''Hub'' page, click on the navbar, then click on "Sources" to navigate to ''Sources'' page.		In the ''Hub'' page, click on the navbar, then click on "Sources" to navigate to ''Sources'' page.
Line 20:		Line 23:

	Fig 2) PCEX Authoring Tool: Hub Page - when user is logged in.		Fig 2) PCEX Authoring Tool: Hub Page - when user is logged in.

	~~<span id="sources"></span>~~
	~~= Sources =~~

	This page contains the list of sources you have created. Click "'''New Source'''" to create a new source.		This page contains the list of sources you have created. Click "'''New Source'''" to create a new source.

Mhassany at 22:14, 1 April 2024

2024-04-01T22:14:28Z

← Older revision		Revision as of 22:14, 1 April 2024
Line 4:		Line 4:

	<ol style="list-style-type: decimal;">		<ol style="list-style-type: decimal;">
	<li>'''Sources''', a source is a PCEX example or challenge; which has a title, problem description, and line-by-line annotated source code.</li>		<li>'''Sources''', a source is a [[PCEX]] example or challenge; which has a title, problem description, and line-by-line annotated source code.</li>
	<li>'''Activities''', an activity is a bundle of multiple sources either as an example or challenge.</li>		<li>'''Activities''', an activity is a bundle of multiple sources either as an example or challenge.</li>
	<li>'''Hub''', is where all publicly available activities are listed which can be searched by title, used, or embedded within your tool (through iframe).</li>		<li>'''Hub''', is where all publicly available activities are listed which can be searched by title, used, or embedded within your tool (through iframe).</li>

Mhassany: added video tutorial

2024-04-01T22:09:40Z

added video tutorial

← Older revision		Revision as of 22:09, 1 April 2024
Line 9:		Line 9:
	</ol>		</ol>

	After opening the [http://adapt2.sis.pitt.edu/pcex-authoring/ <u>PCEX Authoring Tool</u>], you will land on the ''Hub'' page. Click '''Login''', provide your account credentials and login into the tool. Then you will be redirected back to the ''Hub'' page.		After opening the [http://adapt2.sis.pitt.edu/pcex-authoring/ <u>PCEX Authoring Tool</u>] ([https://youtu.be/IOfA0Ql3Zq0 Video Tutorial]), you will land on the ''Hub'' page. Click '''Login''', provide your account credentials and login into the tool. Then you will be redirected back to the ''Hub'' page.

	[[File:weat_image8.png\|936px]]		[[File:weat_image8.png\|936px]]

Mhassany: fix images ref

2024-04-01T22:02:10Z

fix images ref

← Older revision		Revision as of 22:02, 1 April 2024
Line 4:		Line 4:

	<ol style="list-style-type: decimal;">		<ol style="list-style-type: decimal;">
	<li~~><blockquote><p~~>'''''Sources''''', a source is a PCEX example or challenge; which has a title, problem description, and line-by-line annotated source code.~~</p></blockquote>~~</li>		<li>'''Sources''', a source is a PCEX example or challenge; which has a title, problem description, and line-by-line annotated source code.</li>
	<li~~><blockquote><p~~>'''''Activities''''', an activity is a bundle of multiple sources either as an example or challenge.~~</p></blockquote>~~</li>		<li>'''Activities''', an activity is a bundle of multiple sources either as an example or challenge.</li>
	<li~~><blockquote><p~~>'''''Hub''''', is where all publicly available activities are listed which can be searched by title, used, or embedded within your tool (through iframe).~~</p></blockquote>~~</li></ol>		<li>'''Hub''', is where all publicly available activities are listed which can be searched by title, used, or embedded within your tool (through iframe).</li>
			</ol>

	After opening the [http://adapt2.sis.pitt.edu/pcex-authoring/ <u>PCEX Authoring Tool</u>], you will land on the ''Hub'' page. Click '''Login''', provide your account credentials and login into the tool. Then you will be redirected back to the ''Hub'' page.		After opening the [http://adapt2.sis.pitt.edu/pcex-authoring/ <u>PCEX Authoring Tool</u>], you will land on the ''Hub'' page. Click '''Login''', provide your account credentials and login into the tool. Then you will be redirected back to the ''Hub'' page.
Line 45:		Line 46:
	Fig 6) PCEX Authoring Tool: Define distractors (bottom section) for blank lines.		Fig 6) PCEX Authoring Tool: Define distractors (bottom section) for blank lines.

	Explanations for important lines of code can be generated using the ''gpt-3.5-turbo'' model. Clicking on the "'''Generate Explanations'''" button will generate explanations using the default prompt. Newly generated explanations will be appended to the line and are distinguished with orange border color (check Figure 9).		Explanations for important lines of code can be generated using the ''gpt-3.5-turbo'' model. Clicking on the "'''Generate Explanations'''" button will generate explanations using the default prompt. Newly generated explanations will be appended to the line and are distinguished with orange border color (check Figure 7).

	Next to the "'''Generate Explanations'''" button, there is the [[File:weat_image9.png\|48x40px]]history and [[File:weat_image6.png\|44x40px]] custom prompt toggle buttons. Clicking on the [[File:weat_image9.png\|48x40px]] button will show the previously generated explanations (check Figure 7) for this source. While clicking on the [[File:weat_image6.png\|44x40px]] provide the ability to customize the ChatGPT prompt (check Figure 8).		Next to the "'''Generate Explanations'''" button, there is the [[File:weat_image9.png\|48x40px]]history and [[File:weat_image6.png\|44x40px]] custom prompt toggle buttons. Clicking on the [[File:weat_image9.png\|48x40px]] button will show the previously generated explanations (check Figure 7) for this source. While clicking on the [[File:weat_image6.png\|44x40px]] provide the ability to customize the ChatGPT prompt (check Figure 7).

	As described in the user interface, these explanations can be dragged by the bars into the Annotations panel to be used/added to the currently selected line (check Figure 8). By default, previously generated explanations for the currently selected line are shown; click the "'''show all lines'''" to show all generated explanations. In the history panel click on another date/time to load explanations specific to that generation session.		As described in the user interface, these explanations can be dragged by the bars into the Annotations panel to be used/added to the currently selected line (check Figure 8). By default, previously generated explanations for the currently selected line are shown; click the "'''show all lines'''" to show all generated explanations. In the history panel click on another date/time to load explanations specific to that generation session.
Line 59:		Line 60:
	Fig 8) Source Editor: Dragging previously generated explanations from history into the Annotations panel.		Fig 8) Source Editor: Dragging previously generated explanations from history into the Annotations panel.

	In Figure 9, the ChatGPT prompt can be viewed. This is the default prompt used by the tool when "'''Generate Explanations'''" is clicked. If by any reason, it requires any change, you can change the color-marked sections. After customizing the prompt, click "'''Generate Explanations'''" to generate the explanations.		In Figure 7, the ChatGPT prompt can be viewed. This is the default prompt used by the tool when "'''Generate Explanations'''" is clicked. If by any reason, it requires any change, you can change the color-marked sections. After customizing the prompt, click "'''Generate Explanations'''" to generate the explanations.

	In the Annotations panel, explanations can be dragged by the bars. Drag and drop an explanation on another explanation to change their order, or hold "'''alt'''" key while dropping to append/merge them together, or drop the explanation on to the red trash can area to remove it (you will be asked to confirm this action since it is irreversible).		In the Annotations panel, explanations can be dragged by the bars. Drag and drop an explanation on another explanation to change their order, or hold "'''alt'''" key while dropping to append/merge them together, or drop the explanation on to the red trash can area to remove it (you will be asked to confirm this action since it is irreversible).
Line 65:		Line 66:
	[[File:weat_image20.png\|936px]]		[[File:weat_image20.png\|936px]]

	Fig 10) Source Editor: Drag explanations to reorder, merge or remove.		Fig 9) Source Editor: Drag explanations to reorder, merge or remove.

	In case you want to merge, cut, copy, or delete multiple explanations, click on the [[File:weat_image12.png\|33x30px]] button to see more actions. Select explanations by clicking either the "'''Select'''" (to start the selection, then click on the[[File:weat_image15.png\|22x20px]]checkboxes next to explanations to select), or "'''Select all'''" to select all the explanations. Then you can cut, copy, and delete the selected explanations.		In case you want to merge, cut, copy, or delete multiple explanations, click on the [[File:weat_image12.png\|33x30px]] button to see more actions. Select explanations by clicking either the "'''Select'''" (to start the selection, then click on the[[File:weat_image15.png\|22x20px]]checkboxes next to explanations to select), or "'''Select all'''" to select all the explanations. Then you can cut, copy, and delete the selected explanations.
Line 71:		Line 72:
	[[File:weat_image19.png\|936px]]		[[File:weat_image19.png\|936px]]

	Fig 11) Source Editor: Annotations panel more actions.		Fig 10) Source Editor: Annotations panel more actions.

	<span id="activities"></span>		<span id="activities"></span>
Line 80:		Line 81:
	[[File:weat_image7.png\|936px]]		[[File:weat_image7.png\|936px]]

	PCEX Authoring Tool: List of defined activities.		Fig 11) PCEX Authoring Tool: List of defined activities.

	An activity contains one or more sources, either as an example or challenge.		An activity contains one or more sources, either as an example or challenge.
Line 88:		Line 89:
	[[File:weat_image16.png\|936px]]		[[File:weat_image16.png\|936px]]

	PCEX Authoring Tool: Creating an activity(e.g: HelloWorld!).		Fig 12) PCEX Authoring Tool: Creating an activity(e.g: HelloWorld!).

	<span id="hub"></span>		<span id="hub"></span>
Line 97:		Line 98:
	[[File:weat_image8.png\|936px]]		[[File:weat_image8.png\|936px]]

	PCEX Authoring Tool: Hub Page.		Fig 13) PCEX Authoring Tool: Hub Page.

	[[File:weat_image4.png\|936px]]		[[File:weat_image4.png\|936px]]

	PCEX Authoring Tool: Activity Preview.		Fig 14) PCEX Authoring Tool: Activity Preview.

	<span id="icons-and-symbols"></span>		<span id="icons-and-symbols"></span>