191017
Meeting about future of SMARTool on 17.10.2019
Present: Chiara Argese, Radovan Bast, Laura Janda, Trond Trosterud
Agenda
- Migration of SMARTool to Giellatekno
- Overview
- Questions
- Overview
- SMARTool spin-offs for learning of languages other than Russian
- SMARTool with non-English interfaces for learners of Russian
- Other issues
Migration of SMARTool to Giellatekno
Current set-up run by
- Laura Janda
- Valentina Zhukova
- Evgeniia Sudarikova
- Lisa Kibisova
Current practice:
Janda, Zhukova, Sudarikova, Kibisova create and edit content in googlesheets.
- Zhukova regularly (in principle weekly) copies googlesheets to github address
- Github copy serves as source file for SMARTool
- SMARTool code is also on github
Approximately two-thirds of the content is in place now. We hope to complete content by end of 2019.We plan to work on editing and de-bugging in 2020.
Questions:
URL
Will SMARTool retain original URL? If not, will there be a redirect?
The code is, with appr 30 other projects, under https://github.com/uit-no
The content and the code should be at the same github.
We do it as follows: Radovan will move the code and data to a repository of its own https://github.com/smartool and add persons to organization.
Changes
What changes should be made to current practice, especially in terms of github location? Other changes?
Radovan will write a paragraph on how to contribute in the github README. And inform Valentina.
Language choice is now hardcoded to RUS and ENG. This should be generalised as variables. Radovan will look into that. We generalised the spreadsheet columns during the meeting (see below).
Debugging
Who will be in charge of helping with de-bugging?
Radovan will abstract the "hardcoded" language choice to make it easier to plug in other languages. He is also happy to help with debugging questions.
Payment
Content
CLEAR is working on proposals to create a suite of on-line materials for teaching first-year Russian. The SMARTool is part of the package. We will want to have the possibility to access miniature versions of the SMARTool that present only the vocabulary for given lessons. How can we organize this? E.g., if you are in lesson 3, can you pull out the vocabulary from lesson 3?
In order to achieve this, the vocabulary base must then contain a slot for marking lesson(s).
Documentation
Objectively, there are 3 different audiences, here with web pages for Oahpa as an example:
-
http://oahpa.no - pupils, students
-
https://giellalt.uit.no/ped/index.html - internal (and external?) developers
- http://giellatekno.uit.no/icall.sme.html - external researchers
We want the same for SMARTool. The first of these is today's SMARTool page. The second will be an overview page on Github, ,linking, for now, to the different README.md files. Chiara will make that. Laura will provide additional content. We will link to that page from the SMARTool user page, and from our respective CLEAR and Giellateno pages. As for the page for external researchers, we will do that when we have some content for it.
Vocabulary
In order to do this we should ensure the procedures for going from spreadsheet via csv to functioning program is kept automatic, run via scripts.
Buttons
Do we want to have buttons that direct users also to the spin-offs and other interfaces? Or should there be a separate page that gathers all those together? Since these secondary items are not functional yet, maybe this question can be put off?
We will return to this.
SMARTool spin-offs for learning of languages other than Russian
Czech
- Adrian Zasina
- Václav Cvrček
Polish
- Marek Łaziński
- Jacopo Saturno
Laura can help with content.
SMARTool with non-English interfaces for learners of Russian
Languages
Spanish
- Benami Barros
- Andres Cuéllar
Finnish
- Viimaranta, L Johanna
Norwegian
Work to do on adding content
The contact persons have been provided with a miniature version of the googlesheets (one-third of A1) in order to get started. The Spanish contact persons have already added some content, but the Finns haven’t started yet. These persons will eventually need help with turning data into csv in github. We must look at how to set up a procedure so that these versions (or at least the Spanish ones) can be updated and start running.
The contact persons are adding their translations in column N (or should I have them just put those in place of the English translations in column K?). Should they just replace the English glosses in column C or put those in a new column? Should I give them a copy of the rest of the googlesheet and have them continue to add content?
As to the columns, we today have the following ones in Google spreadsheet:
Lemma ID Eng Gloss POS Level Word source Ex. ID Form Analysis Example Sentence Translation Reference Topic(s)
We want a generalised version of this:
Target Language Lemma ID User Language Gloss English Gloss # this is empty if user lg = eng POS Level Word source Ex. ID Form Analysis Target Language Example Sentence User Language Translation Eng translation # empty if user lg = eng Reference Topic(s)
This will have consequences for the numbering of the colums in the input transition from csv to smartool (Radovan will have to look into that).
Documentation, teaching
Radovan will adjust the export routine from csv to smartool to accomodate the new columns (above), and change the spreadsheets. The export routine from csv should be documented.
Original questions
- Who will be in charge of assisting with programming?
- We need to make sure that the data is in the same columns in the source files.
- We need documentation for internal developers, describing how these files are structured.
Given the present setup and the extension sketched here, the actual programming is in place. What is needed is documentation and eventually instructions (documentation and teaching) for translators as to how to transfer spreadsheets to github, or eventually a routine for that. The two other questions are answered above.
Other issues
Grant citation
Radovan plans an article about the code. Please cite the grant in both the publication and in the Cristin registration, and please link the Cristin registration to the CLEAR group (or send Laura the postnummer so that she can link it). Here is grant citation information. Grant agency: Direktoratet for internasjonalisering og kvalitetsutvikling i høyere utdanning Grant number: CPRU-2017/10027
Financing
We should consider looking for some kind of grant funding to support extension of the original SMARTool, plus the spin-offs and additional interfaces.
Possible sources: DIKU, EU, Norgesuniversitetet,
The application should contain financing both for content production, interface and testing.
The first step should still be to make the tool, its content and documentation better based on current resources, and to discuss the situation for programmers at the departments.
Internal communication
Do we need to set up some kind of communication system for all SMARToolers?
(This was not discussed on the meeting. At Giellatekno, we use Zulip, so consider that).
Accessibility
E.g. visual impairment, for lynx-friendliness. Cf. best practices published out there, e.g. from the Norwegian government.
We should keep that in mind when making web pages.
Logo/avatar for GitHub organization
Laura will look into getting a logo.
This would be nice to have for github, and elsewhere.