-
Notifications
You must be signed in to change notification settings - Fork 278
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Projects and Event Categories Implementation #201
Comments
In my draft overview #193 I distilled it down to:
|
I like the addition of a nullable client field in work. Should it be a list of clientelle, instead of just a single client? The name of the Also, let's try to be more generic: not every event is a conference or fundraiser. And let's still not forget about volunteer work. We're on the right track, though, certainly. |
Work items can have projects and projects can simply be used as clients depending on the work. See here: https://github.com/stp-ip/resume-schema/blob/2015-draft/schema.json#L168 Being ambiguous was by design to be able to use it for clients, internal projects, products etc. for work and in a similar way for projects. Volunteer work would be summed up in projects, as not every non-work item is volunteering work, but all volunteering work could be summed up under projects. That's why a non-profit boolean was introduced for projects: https://github.com/stp-ip/resume-schema/blob/2015-draft/schema.json#L263 I agree that not every event is a conference, but that's why the item in itself is just an event. Events can then have talks, which would be used by conferences etc. |
I sense overlap between I also feel that the projects and events sections might be able to be merged. Having a talks field is too narrow a focus. While that may be somewhat normal in our field, if we want jsonresume to be the resume standard, we also have to consider the plumber, the electrician, etc.. For this, I think we should find a combination of your project and events field that means "things that I did outside of my day job". On my own personal resume theme, I called this field +1 non-profit boolean, but we'll have to rename it. |
The thing is one can do highlights at a client or in a specific project and especially outside our profession long term employment is a thing. 10 years at one employer can result in 5 projects. in 2 years per project there can be quite some highlights to report. If only highlights are used, one has a work item, with one project and then lists the highlights. Much more difficult to use highlights for clients/projects. Even a plumber or electrician could go to exhibitions or other work related events. Perhaps with the events section we should not say talks, but something more ambiguous. I would not remove it as in science and even in other professions presentations, talks etc. can be quite important on a resume. Probably a good thing to not force a legal meaning, but provide a more generic type field. |
So then how about a merging of I'm more concerned about jsonresume being generic than I am limiting a certain field: so it's not that we should take away the ability to note professional presentations, we should make that field generic enough that it can be used with multiple professions. I don't know if we call it |
Thing is with various professions, when a project actually means client, one wants to list some highlights. Merging them won't work and client work is quiet generic in my opinion. I would have said training would be an event too and so would seminars. Still don't think projects are the same. Almost in all scientific professions conferences and seminars are quite important. So is for students and as you said training in other professions. |
Here's what we should do at this point: we should start throwing out some examples schemas for different professions, and see how they look with suggested changes. And if they look wrong, we iterate on them. |
I think before doing that extra work we should get some feedback from @aloisdg @KOLANICH @PeterDaveHello on the general direction to cut away some of the ideas and then move into iteration mode. |
And I forgot @JD-Robbs |
I think they can be done in tandem. Here's my thoughts: work: [{
"company": "Carpenters-R-us",
"position": "Carpenter",
"date": ...,
"summary": ...,
"clients": null,
"achievements": [
"did the thing",
"built an awesome house"
]
}],
events: [{
"name": "Carpenter Con"
"location": "New York City",
"role": "attendee",
"date": ...,
"summary": ...,
"achievements": [
"signed autographs",
]
"type": "non-paid",
},
"name": "Carpenter training"
"location": "New York City",
"role": "trainee",
"date": ...,
"summary": ...,
"achivements": [
"learned how to use a hammer",
]
"type": "sponsored",
] Yeah, okay. You're right. Events and projects should be two different things. What would follow after this event list would be a list of projects, similar to EDIT: I like |
One thing so would clients be an array of clients? |
Should it be an array of clients? I figure one project can be done for more than one client? I think achievements should be attached to each work item, a project, or an event. Any achievement I can think of would fit in one of those categories. |
I think clients as it's own entity is wrong and so is the position right under work. |
I think you're a bit confused, what's in the
|
Ah now I get the hierarchie. You are reducing one layer to make it simpler, but add another field, which might not be used. Another thing, which was suggested was having a role per project. As one could be team lead on project A in company 1 and glue maker on project B in company 1. |
I think that first we should decide which kinds of events should be included into a resume. I know only one such a type: talks on conferences. Another events such as some charity events, semihooligan artistic performances, visiting festivals, taking part in amateur open lectures for everybody etc shouldn't be included into a resume: they are irrelevant and tell nothing about skills of applicant, but tell that applicant spends his time on the things irrelevant for hirer, I don't think I should paste such things in my own resume. |
So @KOLANICH brings up a point I believe we should discuss. I think jsonresume, while having 'resume' in the title, should also process CVs. In which, such things like performing, charity outreaches, etc. are notable. I personally have my CV, and my resume, which is a proper subset of my CV that I modify for different companies, depending on the job. The CV never gets changed, and only gets added to as time goes on. I would not like to fork jsonresume into json_CV_ just to add the fields a CV has, but a resume doesn't. |
I agree that local achievements and global achievements are quite important and I think we should provide a default set of data for each. Talking about events, we also wanted to include training and seminars. These are all things, which add to the overall value for the employer. |
+1 global achievements And let's try to think of a generic name for "events" that encompasses "training" + "seminars" + "conferences" + any other generic sort of "event". Is |
I think that trainings should be in "education" section. |
One thing with global achievements so. Right now we have the section awards. Would one list the nobelprice really under achievements or under awards. I would probably move to achievements than instead of awards. |
Yes, |
may be achievements should be typed? |
@KOLANICH That makes sense for education and training. Yes, achievements is an array of strings. |
Oops, a long discussion, sorry that I need to take a while to take a look at all the comments ... |
@chrisdotcode thing is that it makes the standard unclear. As one can do it both ways. I think the first example with an additional subsection makes the hierarchy and work items much cleaner. If we are against an additional hierarchy, I at least vote for differentiating the work name and the employer. How much information is added for the employer we could see. The flat structure using the employer attribute introduces more duplication, which I find bad. The data makes much more sense having projects under work items. Themes still could show each item as it's own work item, but the data should not do that. |
Why not "definitions":{
"achievementsList":{
"type":"array",
"description":"Specify multiple accomplishments",
"items":{
"anyOf":[
{
"$ref":"#/definitions/achievement"
},
{
"type":"string"
}
]
}
},
"achievement":{
"type":"object",
"additionalProperties":true,
"properties":{
"type":{
"type":"string",
"default":"general"
},
"summary":{
"type":"string"
},
"date":{
"$ref":"#/definitions/uniDate"
},
"url":{
"type":"string",
"format":"url"
},
//etc
},
"required":["summary"]
}
} |
And via the type one could set "project", "client" right? This basically adds another layer, but hides it behind the achievements. I'm not sure achievements is the right word then, but I could live with something like that. As long as it has almost all the data a project would have had aka role, name, etc. You seem to like anyOf stuff :P |
Yes, but it'd be stupid. I meant "award", "discovery", "invention" and similar. |
Which not really solves the client use case, it just adds another achievement type. |
trying to follow the thread but it's getting a bit heavy 😄 I feel like we reached some consensus on the other threads about projects, last we agreed was to have them under work items, no? I am unclear on what this new |
Excellent work guys, should we split, a lot to digest but I think everyone is mostly on the same page. Here are some of my notes:
|
Hi all, how about projects that you do outside of work? Maybe pro bono work, or open source contribs? It might not be true that all of my projects need to come under an employer? How would I represent a hobby project? |
That could be done via either So for the current version use the |
Thanks @stp-ip, the separate |
First iteration is now merged into the v1.0.0 branch thanks to @ashes74. |
Is there an ETA for v1.0.0? It would be really cool to use project in the resume. :) |
No ETA on v1 unfortunately. We do rely on contributions to speed it up. If anyone wants to help, take a look at these issues: https://github.com/jsonresume/resume-schema/issues?q=is%3Aissue+is%3Aopen+label%3A%22PR+Needed%22 Also adding to the discussion or even writing proposals from discussions might help. |
Will look at those issues and see if I can help! Anyway, is there a change for a |
I don't have access to the server infra, but if @thomasdavis agrees, we could push the projects change into a new 0.x release. |
That would be really cool! |
@thomasdavis could we do an intermediate release of 0.x to push the project changes into the open. This would already test them and show progress. |
We need a |
Hi @thomasdavis, |
There's a category for work, and one for volunteering. Projects and events (and any others) would likely be implemented in like.
There are several ideas about how these sections will be implemented already. This will be the compilation of those past discussions, and the place for new discussions.
cf. #166, #11, #200, #123, #138
The text was updated successfully, but these errors were encountered: