From a5c88a103414ee5c8f717bf6c26823912780189c Mon Sep 17 00:00:00 2001
From: "Daniel J. Summers"
Date: Sun, 31 Jan 2021 21:57:48 -0500
Subject: [PATCH] Move docs to new page (#4)
Also verify citizen ID on story edit page
---
.../Client/Pages/Citizen/Dashboard.razor | 61 +-----------
.../Client/Pages/HowItWorks.razor | 95 +++++++++++++++++++
.../Pages/SuccessStory/EditStory.razor.cs | 17 +++-
src/JobsJobsJobs/Client/Shared/NavMenu.razor | 5 +
4 files changed, 115 insertions(+), 63 deletions(-)
create mode 100644 src/JobsJobsJobs/Client/Pages/HowItWorks.razor
diff --git a/src/JobsJobsJobs/Client/Pages/Citizen/Dashboard.razor b/src/JobsJobsJobs/Client/Pages/Citizen/Dashboard.razor
index b8a82c7..687a58e 100644
--- a/src/JobsJobsJobs/Client/Pages/Citizen/Dashboard.razor
+++ b/src/JobsJobsJobs/Client/Pages/Citizen/Dashboard.razor
@@ -40,63 +40,8 @@
-
- Phase 3 – What Works
- (v0.8 – Last Updated January 19th, 2021)
-
- The “View Profiles” link at the side now allows you to search for profiles by continent, the
- citizen’s desire for remote work, a skill, or any text in their professional biography and experience. If you
- find someone with whom you’d like to discuss potential opportunities, the name at the top of the profile links
- to their No Agenda Social account, where you can use its features to get in touch.
+ To see what is currently done, and how this application works, check out “How It Works” in the sidebar.
+ The application now has 4 of 5 phases complete towards version 1.0; the documentation was last updated January
+ 31st, 2021.
-
-Phase 2 – What Works (v0.7 – Last Updated January 8th, 2021)
-
- If you’ve gotten this far, you’ve already passed
- Phase 1, which enabled users of
- No Agenda Social to create accounts here, simply by allowing the application read access to their profiles. Unless
- there are requests for tighter integration with that site, this is the only access to your NAS information that this
- application will require.
-
-
- Phase 2 allows you to complete
- your employment profile. Much of this is straightforward, but there are a few things you might want to know before
- you fill it out:
-
-
- -
- The “View Your Employment Profile” link (which you”ll see on this page, once your profile is
- established) shows your profile the way all other validated users will be able to see it (once
- Phase 3 is complete). While
- this site does not perform communication with others over No Agenda Social, the name on employment profiles is a
- link to that user’s profile; from there, others can communicate further with you using the tools Mastodon
- provides.
-
- -
- The “Professional Biography” and “Experience” sections support Markdown, a plain-text way
- to specify formatting quite similar to that provided by word processors. The
- original page for the project is a good
- overview of its capabilities, and the pages at Markdown
- Guide give in-depth lessons to make the most of this language. The version of Markdown employed here supports
- many popular extensions, include smart quotes (turning "a quote" into “a quote”), tables,
- super/subscripts, and more.
-
- -
- Skills are optional, but they are the place to record skills you have. Along with the skill, there is a
- “Notes” section, which can be used to indicate the time you’ve practiced a particular skill, the
- mastery you have of that skill, etc. It is free-form text, so it is all up to you how you utilize the field.
-
- -
- The “Experience” field is intended to capture a chronological or topical employment history; with this
- “quick-n-dirty” implementation, this Markdown box can be used to capture that information however you
- would like it presented to fellow citizens.
-
- -
- Phase 5 includes allowing
- public access to the continent, region, and skills fields of Gitmo Nation citizens who indicate that they are both
- seeking employment and want their information disclosed to public users. The “Allow my
- profile to be searched publicly” checkbox, at the bottom of the page where you edit your employment profile,
- is how you opt your profile in to this list.
-
-
\ No newline at end of file
diff --git a/src/JobsJobsJobs/Client/Pages/HowItWorks.razor b/src/JobsJobsJobs/Client/Pages/HowItWorks.razor
new file mode 100644
index 0000000..52f6be0
--- /dev/null
+++ b/src/JobsJobsJobs/Client/Pages/HowItWorks.razor
@@ -0,0 +1,95 @@
+@page "/how-it-works"
+
+
+
+How It Works
+
+
+ Phase 4 is complete, which means that the entire logged-in version of the application is now available. There are
+ GitHub issues for each one
+ (Phase 1 •
+ Phase 2 •
+ Phase 3 •
+ Phase 4), and if you run into any
+ issues with it, feel free to
+ let us know on GitHub, or look up
+ @("@")danieljsummers on No Agenda Social.
+
+
+Completing Your Profile
+
+ -
+ The “View Your Employment Profile” link (which you”ll see on this page, once your profile is
+ established) shows your profile the way all other validated users will be able to see it. While this site does not
+ perform communication with others over No Agenda Social, the name on employment profiles is a link to that
+ user’s profile; from there, others can communicate further with you using the tools Mastodon provides.
+
+ -
+ The “Professional Biography” and “Experience” sections support Markdown, a plain-text way
+ to specify formatting quite similar to that provided by word processors. The
+ original page for the project is a good
+ overview of its capabilities, and the pages at
+ Markdown Guide give in-depth lessons to make the most
+ of this language. The version of Markdown employed here supports many popular extensions, include smart quotes
+ (turning "a quote" into “a quote”), tables, super/subscripts, and more.
+
+ -
+ Skills are optional, but they are the place to record skills you have. Along with the skill, there is a
+ “Notes” section, which can be used to indicate the time you’ve practiced a particular skill, the
+ mastery you have of that skill, etc. It is free-form text, so it is all up to you how you utilize the field.
+
+ -
+ The “Experience” field is intended to capture a chronological or topical employment history; with this
+ “quick-n-dirty” implementation, this Markdown box can be used to capture that information however you
+ would like it presented to fellow citizens.
+
+ -
+ Phase 5 includes allowing
+ public access to the continent, region, and skills fields of Gitmo Nation citizens who indicate that they are both
+ seeking employment and want their information disclosed to public users. The “Allow my
+ profile to be searched publicly” checkbox, at the bottom of the page where you edit your employment profile,
+ is how you opt your profile in to this list.
+
+
+
+Searching Profiles
+
+ The “View Profiles” link at the side allows you to search for profiles by continent, the citizen’s
+ desire for remote work, a skill, or any text in their professional biography and experience. If you find someone with
+ whom you’d like to discuss potential opportunities, the name at the top of the profile links to their No Agenda
+ Social account, where you can use its features to get in touch.
+
+
+Finding Employment
+
+ If your profile indicates that you are seeking employment, and you secure employment, that is something you will
+ want to update (and – congratulations!). From both the Dashboard and the Edit Profile pages, you will see a
+ link that encourages you to tell us about it. Click either of those links, and you will be brought to a page that
+ allows you to indicate whether your employment actually came from someone finding your profile on Jobs, Jobs, Jobs,
+ and gives you a place to write about the experience. These stories are only viewable by validated users, so feel free
+ to use as much (or as little) identifying information as you’d like. You can also submit this page with all the
+ fields blank; in that case, your “Seeking Employment” flag is cleared, and the “story” is
+ recorded.
+
+
+ As a validated user, you can also view others success stories. Clicking “Success Stories” in the sidebar
+ will display a list of all the stories that have been recorded. If there is a story to be read, there will be a link
+ to read it; if you submitted the story, there will also be an “Edit” link.
+
+
+
+ Publicly Available Information
+ (coming in Phase 5)
+
+
+ The “public” page for profile information will display the following information:
+
+
+ - A count of profiles where the citizen is seeking employment
+ - The citizen’s continent and region
+ - The citizen’s skills and notes
+
+
+ This information will be pullled only from profiles where citizens have said can it be publicly available
+ and are currently seeking employment.
+
diff --git a/src/JobsJobsJobs/Client/Pages/SuccessStory/EditStory.razor.cs b/src/JobsJobsJobs/Client/Pages/SuccessStory/EditStory.razor.cs
index 7605576..1fb9c88 100644
--- a/src/JobsJobsJobs/Client/Pages/SuccessStory/EditStory.razor.cs
+++ b/src/JobsJobsJobs/Client/Pages/SuccessStory/EditStory.razor.cs
@@ -43,12 +43,19 @@ namespace JobsJobsJobs.Client.Pages.SuccessStory
var story = await ServerApi.RetrieveOne(http, $"success/{Id}");
if (story.IsOk && story.Ok != null)
{
- Form = new StoryForm
+ if (story.Ok.CitizenId == state.User!.Id)
{
- Id = story.Ok.Id.ToString(),
- FromHere = story.Ok.FromHere,
- Story = story.Ok.Story?.Text ?? ""
- };
+ Form = new StoryForm
+ {
+ Id = story.Ok.Id.ToString(),
+ FromHere = story.Ok.FromHere,
+ Story = story.Ok.Story?.Text ?? ""
+ };
+ }
+ else
+ {
+ errors.Add("Stop messing with the URL");
+ }
}
else if (story.IsOk)
{
diff --git a/src/JobsJobsJobs/Client/Shared/NavMenu.razor b/src/JobsJobsJobs/Client/Shared/NavMenu.razor
index 6e4f0e6..0aa76bc 100644
--- a/src/JobsJobsJobs/Client/Shared/NavMenu.razor
+++ b/src/JobsJobsJobs/Client/Shared/NavMenu.razor
@@ -52,6 +52,11 @@
}
+
+
+ How It Works
+
+