-
Notifications
You must be signed in to change notification settings - Fork 229
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
Open a wiki page documenting how to start up a new language section #1737
Comments
In order to work more efficiently on this, I think it's wiser to create at least three subcategories at this wiki page , mainly corresponding to different teams within the project. The lead of each team should have an overview of the process and check in with the New Publications manager (@JoshuaGOB ) and the managing editor/ contact person of the new publication.
|
@amsichani is this a guide for new teams AFTER a publication has been approved? I'm thinking of #1718 |
hi @acrymble , I think yes, its a guide for new teams after the publication has been approved. I am not sure whether we have decided to have a more formal way of approving a publication at this point, but as far as I know the Portuguese team are now working towards their infrastructure. So I guess #1718 would be step 1 and this ticket /tasklist would be step 2 of an onboarding process of a new publication. @JoshuaGOB what you think? |
Just chiming in as I saw it on my email, I guess it will also serve as a pointer to new teams when they contact us (wiki-see all that you would have to do), and before we do #1718, no? |
I agree @jenniferisasi . Its best to have something on our wiki for potential teams willing to undertake a whole new publication instead of answering individual emails every now and then. |
Is @JoshuaGOB involved in this too? I definitely see that there are technical elements that need documenting, but this also heavily involves his role in onboarding the new team. Can we make sure those conversations across teams are happening? And can you let me know if we need help to facilitate that? |
yes, @JoshuaGOB should be /is definitely involved in this, esp with his experience with the PT team and as New Publications manager. |
Started up the technical page here: https://github.com/programminghistorian/jekyll/wiki/Technical-Tutorial-on-Setting-Up-a-New-Language I've covered most of the technical tasks I can think of - @amsichani and @programminghistorian/technical-team please give it a look and let me know what needs clarification or if I'm missing anything. |
@mdlincoln I might add at the front of the process opening a template issue on the repository with a technical tasklist that lists each of these things. It seems like the technical task of onboarding a new team should have its own ticket separate from the social/professional task of onboarding them. Because my sense is that you've been doing a number of these things for PT because you know to do them, but I'm not certain where we are in the process. If I were to be following this without you here I'd want a roadmap that I can tick things off publicly so that the rest of the technical team has them all in place. Other than that, you'd know best. I wouldn't really know what other technical components this would entail until I ran through the list and noticed that things weren't working. Thanks for putting this together. |
That's a very good idea @walshbr - will add to the instructions and also open such a ticket |
done #1802 |
Hi all, I am now finalising the wiki page on this and I realised that we can also reflect and update the information we have on the New Publications Manager role, currently @JoshuaGOB. |
@JoshuaGOB has just joined the global team @amsichani since this made the most sense given our conversations at the last team meeting. |
thanks for the update @acrymble , waiting now for a small on the role at the relevant wiki page. |
Here we are -- https://github.com/programminghistorian/jekyll/wiki/How-to-start-up-a-new-language-publication . |
This is great @amsichani, thank you. Since the process is still ongoing I agree that it should be a living document and I will add any other points as they arise during the rest of the onboarding process. I was also considering if we should add a "Helpful Suggestions" section for some of the items. For example, how spread out the onboarding of editors should be, setting up an efficient schedule for the translation of the core pages so they don't fall out of sync with the main branch, and creating documentation along the lines of what the French team provides https://github.com/programminghistorian/jekyll/wiki/French-Translation-Documentation |
I'll this issue for discussion in our next meeting |
@drjwbaker, I was wondering if we should add here a task related to setting up the DOI for a new language publication. For example, when we should inform University of Sussex Library about the new language? |
@rivaquiroga Yes, we have a MOU with them: https://github.com/programminghistorian/project-and-business-archive/blob/master/project/2020/2020-04_Sussex-DOI-MOU/2020-05-18_ProgHist%20MOU%20w%20University%20of%20Sussex.docx See item 4. under the PH Ltd responsibilities:
I suspect this falls on me. In the case of the PT publication, someone (@DanielAlvesLABDH @JoshuaGOB?) will need to tag me with this action on a relevant ticket. I can then ask them on our behalf. |
On https://github.com/programminghistorian/jekyll/wiki/Technical-Tutorial-on-Setting-Up-a-New-Language#ask-drjwbaker-on-behalf-of-the-ltd-to-check-with-the-doi-provider-that-they-are-happy-provide-dois-for-a-new-publication-if-the-provider-cannot-supply-dois-the-new-publication-will-run-without-dois-until-the-ltd-finds-a-solution there is not much more to add than what it says, accept that - just in case I fall under a bus - the task should probably be to ask the someone at the Ltd to ask our DOI supplier. |
@JoshuaGOB am I right in thinking this can now be closed? I added the guide that AM put together to the table of contents on the right side of the wiki. Seems like PT is basically up and running - we just need to get the final DOI to launch them. And I updated the technical guidance for setting up a new language publication based on @drjwbaker's suggestion. |
Agreed, thank you all. |
The text was updated successfully, but these errors were encountered: