B-Translator                            as a     Software Engineering Project                   Dashamir Hoxha            ...
What is Software Engineering●   Soft-Eng = Programing + Project Management●   Software Engineering tries to make efficient...
Basic development models and steps●   Development models        ●   Waterfall steps     –   Waterfall                –   r...
Requirements:1 - Conception of the software●   Why it is needed, what it will be used for?●   The problems that B-Translat...
The meaning of B-Translator
Requirements:2 - Description of desired features●   Description of what the software should do and    how it should do it....
Analysis:3 - The functionality in more details●   Think about how the software should work.●   Steps of the functional ana...
The actors of B-Translator●   guest (anonymous user)●   contributor (authenticated user)●   translator●   moderator●   adm...
The use-cases of B-Translator (1)●   guest (anonymous user)    –   get translation suggestions for a string    –   search ...
The use-cases of B-Translator (2)●   translator    –   all the use-cases of contributor    –   import translation files   ...
The use-cases of B-Translator (3)●   script    –   update translation data with the latest versions    –   notify users ab...
Analysis:3 - The functionality in more details●   Describing user interfaces (UI) helps to define    the functionality.●  ...
Design:4 – Designing the software●   Design is a description in logical (abstract) terms of the parts and    components th...
The DB schema of B-Translator●   The DB tables of B-Translator:    –   Files: Translation (PO) files that can be imported ...
DB Diagram: Tables and their relations.
Structure of the DB (1)
Structure of the DB (2)
Structure of the DB (3)
Implementation:5 – Development tools and infrastructure●   Implementation is the process of actually building the    softw...
Development infrastructure of B-Translator●   web application running on LAMP    (Linux+Apache+MySQL+PHP)●   Drupal7 as a ...
6 - Managing the project●   Software engineering is not just about programing or    development, but also about project ma...
B-Translator has followed an iterative and              incremental life cycle●   The design of the database became more c...
How to install B-Translator●   Install the Drupal7 profile btranslator:     cd /var/www/     sudo git clone https://github...
Documentation:How B-Translator worksThe process/workflow for a project without translation:   1. Checkout POT files from t...
Documentation:How B-Translator worksThe process/workflow for the case when the feedback provided by thesystem is integrate...
Some software development                general principles and advices●   First make it work, then make it better.    –  ...
Where is used B-Translator●   There is a working demo/testing site at:      https://l10n.org.al/translations/●   The main ...
B-Translator as a Software Engineering Project
Upcoming SlideShare
Loading in...5
×

B-Translator as a Software Engineering Project

1,519

Published on

The project B-Translator is presented, trying to illustrate through it some software development/engineering concepts and practices (how they are actually applied in this project).

Published in: Technology, Business
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total Views
1,519
On Slideshare
0
From Embeds
0
Number of Embeds
2
Actions
Shares
0
Downloads
20
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

B-Translator as a Software Engineering Project

  1. 1. B-Translator as a Software Engineering Project Dashamir Hoxha dashohoxha@gmail.com● Presentation of the project B-Translator● Illustration of software engineering concepts and practices
  2. 2. What is Software Engineering● Soft-Eng = Programing + Project Management● Software Engineering tries to make efficient and effective the process of developing new software, by identifying and trying to use principles and practices that have proved to be successful on the past projects.● It is more like an art than like an exact discipline.
  3. 3. Basic development models and steps● Development models ● Waterfall steps – Waterfall – requirements – Iterative and – analysis incremental – design – Agile development – implementation – Extreme programing – testing – Etc. – deployment – maintenance
  4. 4. Requirements:1 - Conception of the software● Why it is needed, what it will be used for?● The problems that B-Translator tries to solve – Getting feedback about the translations from a wide crowd of people and users. ● votes for the best translation ● a new alternative translation ● a new translation suggestion – Helping to ensure consistency among the translations. – Merging translations from different sources.● Are there any existing alternatives – Maybe Pootle?
  5. 5. The meaning of B-Translator
  6. 6. Requirements:2 - Description of desired features● Description of what the software should do and how it should do it.● The features of B-Translator – Open access – Authenticated voting – Tracking votes – Highly customizable – Evaluating the performance – Detailed and comprehensive reporting and statistics – Integration with the existing workflow of the project translations
  7. 7. Analysis:3 - The functionality in more details● Think about how the software should work.● Steps of the functional analysis: – identify the actors (users or other programs/components that are interacting with our software/system) – identify use cases (all the different cases when the actors need to interact with our software/system) – describe each use case (the details of how each interaction is done)
  8. 8. The actors of B-Translator● guest (anonymous user)● contributor (authenticated user)● translator● moderator● administrator● script● peer B-Translator installation
  9. 9. The use-cases of B-Translator (1)● guest (anonymous user) – get translation suggestions for a string – search strings and translations – export translations – comment on translations● contributor (authenticated user) – all the use-cases of guest – customize his own preferences and settings – vote (or like) translations – suggest new translations – flag inappropriate comments or translations – check his own contribution details in a dashboard
  10. 10. The use-cases of B-Translator (2)● translator – all the use-cases of contributor – import translation files – export translations and suggestions● moderator – all the use-cases of contributor – access statistics and other details – resolve flagged comments and translations● administrator – manage overall software configuration – manage user access rights and permissions
  11. 11. The use-cases of B-Translator (3)● script – update translation data with the latest versions – notify users about relevant issues – apply suggested translations upstream, wherever possible and suitable● peer B-Translator installation – request sync data (in case there are several B- Translation installations, they should be able to synchronize the data with each-other, if needed)
  12. 12. Analysis:3 - The functionality in more details● Describing user interfaces (UI) helps to define the functionality.● User Interfaces of B-Translator: – search existing strings and translations – vote existing translations or suggest new ones – export/import PO files – Admin interfaces (general config, reports and stats, etc.) – User profile (preferencies, settings, etc.)
  13. 13. Design:4 – Designing the software● Design is a description in logical (abstract) terms of the parts and components that will make up the software, how they are composed, how they interact with each-other, etc.● The design usually describes: – database entities and relationships – interfaces of the application (in more details) – APIs (Application Programing Interfaces) – classes, objects and their relationships – the most important processes and algorithms, etc.● UML diagrams can be useful again for describing concisely and clearly the entities, their relationships and interactions.● A good design should try to capture only the most important things, leaving out the obvious or unimportant things.
  14. 14. The DB schema of B-Translator● The DB tables of B-Translator: – Files: Translation (PO) files that can be imported and exported from the DB. – Templates: POT files that are imported. – Projects: A project is the software/application which is translated by the PO files. – Locations: Locations (lines) where a l10n string is found. – Strings: Translatable strings that are extracted from projects. – Translations: Translations/suggestions of the l10n strings. For each string there can be translations for different languages, and more than one translation for each language. – Votes: Votes for each translation/suggestion. – Users: Users that contribute translations/suggestions/votes. – Snapshots: Snapshots are tgz archives of project-lng translation files. – Diffs: Diffs between the current state and the last snapshot.
  15. 15. DB Diagram: Tables and their relations.
  16. 16. Structure of the DB (1)
  17. 17. Structure of the DB (2)
  18. 18. Structure of the DB (3)
  19. 19. Implementation:5 – Development tools and infrastructure● Implementation is the process of actually building the software. Before the implementation starts, several decisions have to be done, like: – what platform to use – what programing language or framework should be used – what database should be used – what tools to use for development – how to coordinate the work of several developers – programing standards to be used – etc.
  20. 20. Development infrastructure of B-Translator● web application running on LAMP (Linux+Apache+MySQL+PHP)● Drupal7 as a development framework● Emacs for coding● Git on github.com for configuration management: https://github.com/dashohoxha/B-Translator● There is a group/forum/mailing-list B-Translator on Google, for notifications, discussions, etc.● chatroom #btranslator on irc.freenode.net
  21. 21. 6 - Managing the project● Software engineering is not just about programing or development, but also about project management. Project management includes: – making a plan about how we are going to build the software – defining the things or tasks that need to be done – breaking down the tasks into smaller ones – assigning importance or priorities to the tasks – finding inter-dependencies between the tasks – defining milestones and grouping tasks to them – assigning tasks to people, etc● The tool that I use for keeping the project organized is the mode-org of Emacs (http://orgmode.org)
  22. 22. B-Translator has followed an iterative and incremental life cycle● The design of the database became more clear only after starting to implement it.● Actually I had to change the structure of the database several times, until it was suitable.● Initially I depended on importing the data collected by open-tran.eu. However, I decided later to implement my own scripts for getting translation files and importing them on the DB.● Integration with the existing workflow of the project translations was something that occurred to me later, after I had started implementation.● Integration required the ability to import and export PO files, and this made me add some extra tables for keeping the relevant information.● Initially I did not think about the possibility of exporting diff (and ediff) files. After deciding to implement such a feature, I had to add a few more tables in the design of the database.● The possibility for appending comments to each translation was suggested to me by one of the translators.
  23. 23. How to install B-Translator● Install the Drupal7 profile btranslator: cd /var/www/ sudo git clone https://github.com/dashohoxha/B-Translator.git sudo B-Translator/install/all.sh● Apache configuration: ### directory where application is installed <Directory /var/www/l10n-dev/> Options Indexes FollowSymLinks MultiViews # AllowOverride None AllowOverride All ### this is needed for clean URLs Order allow,deny allow from all </Directory>
  24. 24. Documentation:How B-Translator worksThe process/workflow for a project without translation: 1. Checkout POT files from the repository of the project. 2. Import them into the DB. 3. Over some time, collect translation suggestions from the users. These translations can also be reviewed and evaluated by other users. 4. Export the PO files from the DB. 5. Review, fix and reformat them as needed. 6. Upload/commit the PO files into the repository of the project. 7. When a new POT file is released, start over again from the beginning (but this time we also import the PO file, besides the POT file).
  25. 25. Documentation:How B-Translator worksThe process/workflow for the case when the feedback provided by thesystem is integrated in the mainstream translation: 1. Checkout the latest version of the POT and PO files from the repository of the project. 2. Import POT files and PO files into the DB. 3. Over some time, collect votes and new translation suggestions from the users. 4. Time after time (for example each month), the mainstream translator checks out the last diffs, containing the latest suggestions (and makes a snapshot as well). 5. The translator reviews the latest suggestions and applies them in the mainstream translation, if he finds them appropriate. 6. Periodically (for example once or twice a year) go back to steps (1) and (2) and import the POT and PO files again. This re-import may introduce new strings and translations, but will not affect the existing strings, translations and votes.
  26. 26. Some software development general principles and advices● First make it work, then make it better. – Build a working prototype, then improve it by incremental changes.● Dont break the code, keep it always running. – Dont push anything without testing it thoroughly. – If possible apply automated testing. – Apply zero tolerance to bugs and errors.● Solve first the most risky problems.● Be transparent with users and stakeholders. – Involve users since the early stages. – Release early, release often. – Try to build a community.● Write code for other people. – Write clean and readable code. – Comment properly. – Dont neglect documentation.
  27. 27. Where is used B-Translator● There is a working demo/testing site at: https://l10n.org.al/translations/● The main goal of the site is to help the process of translating programs into Albanian.● It also serves as a testbed for B-Translator.● If you would like to help, register there and give your feedback for translations and for B-Translator.● If you would like to help for developing B-Translator, contact me at: dashohoxha@gmail.com
  1. A particular slide catching your eye?

    Clipping is a handy way to collect important slides you want to go back to later.

×