Changes

[[File:Portfolio-Tool.png]]

[[File:Portfolio-Tool.png]]

== How to use Portfolio ==

== Using Portfolio ==

Before you launch the activity, use the ☆ on the left of each Journal entry to mark that entry for inclusion in the portfolio. The Portfolio Activity will use the entry title as well as the preview image and description.

Before you launch the activity, use the ☆ on the left of each Journal entry to mark that entry for inclusion in the portfolio. The Portfolio Activity will use the entry title as well as the preview image and description.

;Save Button: active when there is a new recording to save

;Save Button: active when there is a new recording to save

=== Save to PDF ===

=== Saving to PDF ===

Each time your launch the Portfolio activity, it will update to reflect the current contents of your Journal. If you want to save a portfolio that represents a particular moment in time (or you want to share your portfolio with someone else), you need to save it as a PDF document. Click on the "Save as PDF" Button from the Activity toolbar menu and the content of the portfolio will be saved as a document in the Journal.

Each time your launch the Portfolio activity, it will update to reflect the current contents of your Journal. If you want to save a portfolio that represents a particular moment in time (or you want to share your portfolio with someone else), you need to save it as a PDF document. Click on the "Save as PDF" Button from the Activity toolbar menu and the content of the portfolio will be saved as a document in the Journal.

[[File:Step2.png|300px]]

[[File:Step2.png|300px]]

===Sample portfolios===

===Samples of student work===

<gallery>

<gallery>

You can report bugs and make feature requests [https://bugs.sugarlabs.org/newticket?component=Portfolio on our bug-tracking system] (You need to create an account first). To list all open tickets of Portfolio you can use [https://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=new&status=reopened&component=Portfolio query component=Portfolio]. You are also welcome to leave comments/suggestions on the [[Talk:Activities/Portfolio]] page.

You can report bugs and make feature requests [https://bugs.sugarlabs.org/newticket?component=Portfolio on our bug-tracking system] (You need to create an account first). To list all open tickets of Portfolio you can use [https://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=new&status=reopened&component=Portfolio query component=Portfolio]. You are also welcome to leave comments/suggestions on the [[Talk:Activities/Portfolio]] page.

== A word to educators ==

== Learning with Portfolio ==

Most education experts agree that the best approach to learning involves doing and then stepping back to reflect on the doing: What did I learn? How can I use that? What questions do I have?1 By helping children to ask good questions about the things they’ve done, as opposed to remembering the right answers, we are helping them to build the critical thinking skills that enable them to be independent problem solvers. Without reflection, learning is an open loop, and an open-loop system can neither identify and correct errors nor adapt to change.

Most education experts agree that the best approach to learning involves doing and then stepping back to reflect on the doing: What did I learn? How can I use that? What questions do I have?1 By helping children to ask good questions about the things they’ve done, as opposed to remembering the right answers, we are helping them to build the critical thinking skills that enable them to be independent problem solvers. Without reflection, learning is an open loop, and an open-loop system can neither identify and correct errors nor adapt to change.

Periodic PDF snapshots are also a great way to preserve a record of each child's work, and as a vehicle for assessing progress.

Periodic PDF snapshots are also a great way to preserve a record of each child's work, and as a vehicle for assessing progress.

== A word to developers ==

=== A word to developers ===

Reflection is an important part of learning and a good habit to establish in general. An analog to writing descriptions in the Journal -- the text that is shown in the Portfolio presentations -- is writing commit messages in git. It forces you to stop, reflect, and then articulate to others what you have done and why.

Reflection is an important part of learning and a good habit to establish in general. An analog to writing descriptions in the Journal -- the text that is shown in the Portfolio presentations -- is writing commit messages in git. It forces you to stop, reflect, and then articulate to others what you have done and why.

== Suggestions for enhancements ==

== Extending Portfolio ==

Manuq made some mock-ups of other layouts. It would be fun to add alternative layout options (or even add support for style sheets).

* Manuq made some mock-ups of other layouts. It would be fun to add alternative layout options (or even add support for style sheets).

<gallery>

<gallery>

File:Portfolio_slide_vertical.png

File:Portfolio_slide_vertical.png

</gallery>

</gallery>

----

----