WIP on profile help

This commit is contained in:
Daniel J. Summers 2023-01-29 16:03:05 -05:00
parent ff68864879
commit 1e2f189051

View File

@ -651,13 +651,13 @@ module Help =
p [] [ p [] [
span [ _class "fst-italic" ] [ span [ _class "fst-italic" ] [
txt "On this page: " txt "On this page: "
a [ _href "#creating" ] [ txt "Creating, Editing, and Sharing Your Employment Profile" ] a [ _href "#creating" ] [ txt "Creating and Editing Your Employment Profile" ]
txt " • "; a [ _href "#searching" ] [ txt "Searching Employment Profiles" ]; txt " • " txt " • "; a [ _href "#searching" ] [ txt "Searching Employment Profiles" ]; txt " • "
a [ _href "#viewing" ] [ txt "Viewing and Printing Employment Profiles" ] a [ _href "#viewing" ] [ txt "Viewing, Printing, and Sharing Employment Profiles" ]
] ]
] ]
h4 [ _id "creating"; mainHeading ] [ txt "Creating, Editing, and Sharing Your Employment Profile" ] h4 [ _id "creating"; mainHeading ] [ txt "Creating and Editing Your Employment Profile" ]
p [] [ p [] [
txt "The employment profile is your résumé, visible to other citizens here. On your " txt "The employment profile is your résumé, visible to other citizens here. On your "
txt "dashboard, there we be either a "; span [ actionButton ] [ txt "Create Profile" ]; txt " or an " txt "dashboard, there we be either a "; span [ actionButton ] [ txt "Create Profile" ]; txt " or an "
@ -665,7 +665,12 @@ module Help =
txt "established yet. There is also a "; span [ linkedPage ] [ txt "My Employment Profile" ] txt "established yet. There is also a "; span [ linkedPage ] [ txt "My Employment Profile" ]
txt " entry in the menu when you are logged on." txt " entry in the menu when you are logged on."
] ]
p [] [ txt "The employment profile itself is divided into three sections." ] p [] [
txt "The employment profile itself is divided into three sections, and the main edit page serves as a "
txt "menu for them. If you have a profile established, there is a button labeled "
span [ actionButton ] [ txt "View Your Employment Profile" ]; txt " which will show you your profile "
txt "the way other users will see it."
]
h5 [] [ txt "General Information" ] h5 [] [ txt "General Information" ]
p [] [ p [] [
@ -683,7 +688,7 @@ module Help =
li [] [ li [] [
strong [] [ txt "Three Yes/No Questions" ]; txt ": If you are actively seeking work, check the " strong [] [ txt "Three Yes/No Questions" ]; txt ": If you are actively seeking work, check the "
txt "“I am currently seeking employment” box; if you are interested in full-time or " txt "“I am currently seeking employment” box; if you are interested in full-time or "
txt "remote work, check those boxes. Leaving them unchecked impmlies “No”." txt "remote work, check those boxes. Leaving them unchecked implies “No”."
] ]
li [] [ li [] [
strong [] [ txt "Professional Biography" ]; txt " (required): Your description of what type of job " strong [] [ txt "Professional Biography" ]; txt " (required): Your description of what type of job "
@ -701,46 +706,86 @@ module Help =
txt "you want displayed at the bottom of your profile." txt "you want displayed at the bottom of your profile."
] ]
li [] [ li [] [
strong [] [ txt "Visibility" ]; txt " (required): There are four visibility options for your " strong [] [ txt "Visibility" ]; txt " (required):"
txt "profile. "; em [] [ txt "Hidden" ]; txt " will restrict your profile to yourself only; this " ul [] [
txt "can be used while you are initially building your profile, or to remove your profile from " li [] [
txt "search results without deleting it. "; em [] [ txt "Private" ]; txt " will restrict your " em [] [ txt "Hidden" ]; txt " will restrict your profile to yourself only; this "
txt "profile to logged-on users of this community. "; em [] [ txt "Anonymous"]; txt " will allow " txt "can be used while you are initially building your profile, or to remove your profile "
txt "your continent, region, and skills to be displayed in public searches, without linking to " txt "from search results without deleting it."
txt "your profile or disclosing any additional information." ]
li [] [
em [] [ txt "Private" ]; txt " (the default) will restrict your profile to logged-on users "
txt "of this community."
]
li [] [
em [] [ txt "Anonymous"]; txt " will allow your continent, region, and skills to be "
txt "displayed in public searches, without linking to your profile or disclosing any "
txt "additional information."
]
li [] [
em [] [ txt "Public" ]; txt " will allow public users to search, view, and print your "
txt "profile, just as you or logged-on users can. It also allows you to share the link to "
txt "your employment profile with the general public."
] ]
] ]
]
]
h5 [] [ txt "Skills" ]
p [] [
txt "The "; span [ linkedPage ] [ txt "Skills" ]; txt " section allows you to record skills you have "
txt "obtained. Each skill has an associated “Notes” field, which can be used to document "
txt "your level of proficiency, years practiced, etc. Skills will be sorted alphabetically, and "
txt "displayed in the profile just below the “Professional Biography”."
]
p [] [
txt "Note that if you select “Anonymous” visibility, what you enter in these fields will "
txt "visible in public search results. In this case, be sure to omit any identifying information from "
txt "either field."
]
h5 [] [ txt "Employment History" ]
p [] [
txt "The "; span [ linkedPage ] [ txt "Employment History" ]; txt " section allows you to record a "
txt "chronological listing of your previous or current employment. This section is sorted descendingly "
txt "(most recent first) by end date, with ongoing jobs listed first. If any entries are present, "
txt "they will be displayed below the list of skills (or below the “Professional "
txt "Biography”, if no skills are present)."
]
p [] [
txt "Each employment history entry consists of the following fields:"
]
ul [] [
li [] [
strong [] [ txt "Employer" ]; txt " (required): The name of the entity by which you were employed"
]
li [] [
strong [] [ txt "Title or Position" ]; txt " (required): The title or job position you held with "
txt "the employer, usually the most recent or senior"
]
li [] [
strong [] [ txt "Start Date" ]; txt " (required): The date you began this period of employment. "
txt "While you will see a full calendar, only the month and year will be displayed on the "
txt "employment profile, so you may select any day within the month."
]
li [] [
strong [] [ txt "End Date" ]; txt ": The date you ended this period of employment. As with the "
txt "“Start Date” field, it will only display month and year. Also, if you still have "
txt "this job, leave this blank, and “to Present” will be displayed for the end date."
]
li [] [
strong [] [ txt "Description" ]; txt ": An optional description of your employment. This field "
txt "supports Markdown, and will appear below the employer, position, and dates if present."
]
]
h4 [ _id "searching"; mainHeading ] [ txt "Searching Employment Profiles" ]
p [] [
txt "The employment profile search form will be slightly different depending on whether there is a "
txt "user logged on or not. There are "
]
// TODO: this is substantially different // TODO: this is substantially different
// p [] [
// The employment profile is your résumé, visible to other citizens here. It also allows you to specify
// your real name, if you so desire; if that is filled in, that is how you will be identified in search results,
// profile views, etc. If not, you will be identified as you are on your Mastodon instance; this system updates your
// current display name each time you log on.
// ]
// h5 Completing Your Profile
// p.
// The #[span.link My Employment Profile] page lets you establish or modify your employment profile; the
// #[span.link Dashboard] page also has buttons that let you create, edit, and view your profile.
// ul
// li.
// The #[span.link Professional Biography] is the “Objective” part of a traditional résumé.
// This section supports #[a(href="#markdown") Markdown], so you can include actual headings, formatting, etc.
// li.
// Skills are optional, but they are the place to record skills you have. Along with each skill, there is a
// #[span.link Notes] field, 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.
// li.
// The #[span.link Experience] field is intended to capture a chronological or topical employment history. This
// Markdown space can be used to capture chronological history, certifications, or any other information –
// however you would like it presented to fellow citizens.
// #[em.text-muted (If you would like a chronological job builder, reach out and let us know.)]
// li.
// If you check the #[span.link Allow my profile to be searched publicly] checkbox #[strong and] you are seeking
// employment, your continent, region, and skills fields will be searchable and displayed to public users of the
// site. They will not be tied to your Mastodon handle or real name; they are there to let people peek behind the
// curtain a bit, and hopefully inspire them to join us.
// h5 Viewing and Sharing Your Profile // h5 Viewing and Sharing Your Profile
// p. // p.
// Once your profile has been established, the #[span.link My Employment Profile] page will have a button at the bottom // Once your profile has been established, the #[span.link My Employment Profile] page will have a button at the bottom
@ -766,14 +811,6 @@ module Help =
// As a validated user, you can also view others success stories. Clicking #[span.link Success Stories] in the sidebar // As a validated user, you can also view others success stories. Clicking #[span.link 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 // 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 #[span.link Edit] link. // to read it; if you submitted the story, there will also be an #[span.link Edit] link.
// h5 Publicly Available Information
// p.
// The #[span.link Job Seekers] page for profile information will allow users to search for and display the continent,
// region, skills, and notes of users who are seeking employment #[strong and] have opted in to their information being
// publicly searchable. If you are a public user, this information is always the latest we have; check out the link at
// the top of the search results for how you can learn more about these fine human resources!
] ]
|> pageWithTitle "How It Works: Employment Profiles" |> pageWithTitle "How It Works: Employment Profiles"