வெளியீட்டு-கண்காணிப்பு வழிகாட்டுதல்கள்

இந்த ஆவணம் UBports திட்டங்களில் உள்ள சிக்கல்களைக் கையாள்வதற்கான நிலையான செயல்முறையை விவரிக்கிறது. (ஒரு நல்ல பிழை அறிக்கையை எழுதுவதற்கான வழிகாட்டி உடன் குழப்பமடைய வேண்டாம்.)

பிழைகள் எங்கே கண்காணிக்கப்படுகின்றன?

Ubuntu Touchக்கான முதன்மை சிக்கல் கண்காணிப்பு ubports/development/ubuntu-touch GitLab project ஆகும். இந்தத் திட்டம் அனைத்து கணினி-நிலை உபுண்டு டச் சிக்கல்களையும் கண்காணிக்கிறது, மேலும் பயனர்கள் தாங்கள் சந்தித்த சிக்கல்களைப் புகாரளிப்பதற்கான நுழைவுப் புள்ளியாக செயல்படுகிறது.

இதற்கிடையில், குழுவில் உள்ள பிற திட்டங்களும் அவற்றின் சிக்கல் கண்காணிப்பாளர்களையும் இயக்கியுள்ளன:

  • சாதனம் சார்ந்த சிக்கல்கள் ஒவ்வொரு சாதனத்தின் திட்டத்திலும் ubports/porting குழுவின் கீழ் கண்காணிக்கப்படும்.

  • ubports/development/apps இன் கீழ் உள்ள முக்கிய பயன்பாடுகள் அவற்றின் சொந்த சிக்கல்களைக் கண்காணிக்கும்.

  • ஒரு சிக்கலுக்குப் பொறுப்பான கூறு எது என்பது தெளிவாகத் தெரிந்தால், கணினிச் சிக்கல்கள் ஒவ்வொரு கூறுகளுக்கும் எதிராக நேரடியாக ubports/development/core இன் கீழ் தாக்கல் செய்யப்படலாம்.

GitLab ஆனது குழு முழுவதிலும் உள்ள சிக்கல்கள், குறுக்கு-திட்ட சிக்கல் குறிப்பு மற்றும் திட்டங்களுக்கிடையில் சிக்கல் பரிமாற்றம் ஆகியவற்றைக் காட்ட அனுமதிக்கிறது. போர்ட்-குறிப்பிட்ட அல்லது இணையதளச் சிக்கல் ubports/development/ubuntu-touch திட்டத்தில் முடிந்தால், அவை பொருத்தமான திட்டத்திற்கு நகர்த்தப்படலாம்.

சிட்டைகள்

All issues — even closed ones — should be labeled to allow use of GitLab's filtering. For example, these are issues labeled 'Kind: enhancement' inside ubports/development group. Consult the GitLab help pages to learn more about searching and filtering.

UBports திட்டங்களுக்குள் பின்வரும் லேபிள்கள் பயன்படுத்தப்படுகின்றன. GitLab இல் உள்ள ஒன்றிணைக்கும் கோரிக்கைகள் (MRs) ஒரே மாதிரியான லேபிள்களைப் பகிர்வதால், கீழே உள்ள சில லேபிள்கள் ஒன்றிணைக்கும் கோரிக்கைகளுக்கும் பொருந்தும்.

அனைத்தும்

ஒன்றிணைப்பு கோரிக்கைகளை கையாள்வதற்கான செயல்முறை பற்றிய ஆவணத்தை எழுதவும்.

  • வகை: சிக்கலின் தன்மையை விவரிக்கவும்
    • வகை: பிழை: இந்த இதழ் சரியாக வேலை செய்யாத ஒன்றை விவரிக்கிறது.

    • வகை: மேம்பாடு: இந்தச் சிக்கல் அம்சக் கோரிக்கை அல்லது மேம்படுத்தக்கூடிய ஒன்றை விவரிக்கிறது.

    • வகை: பராமரிப்பு: இந்த சிக்கல் ஒரு தொழில்நுட்ப கடனை விவரிக்கிறது; நாம் தூய்மை செய்ய வேண்டிய ஒன்று.

    • வகை: FTBFS: இந்த இதழ் "மூலத்திலிருந்து உருவாக்கத் தவறியது" சிக்கலை விவரிக்கிறது (டெபியனின் சுருக்கம்).

    • வகை: செயல்முறை: இந்தச் சிக்கல் சில செயல்முறைகளுக்கான கண்காணிப்புச் சிக்கலாகும். எடுத்துக்காட்டாக, உபுண்டு டச் வெளியீட்டை வெளியிடுவதற்கான செயல்முறை.

    • வகை: கேள்வி: இந்தச் சிக்கல் உதவி கோரிக்கை அல்லது பொதுவான கேள்வி. அதற்கு பதிலாக மன்றங்களுக்கு அனுப்ப வேண்டும்.

  • தேவைகள்: செய்யக்கூடிய/செய்ய வேண்டிய சில செயல்களை விவரிக்கவும்
    • தேவைகள்: சமூகத்தின் உதவி: பராமரிப்பாளர்களுக்கு தற்போது இந்தச் சிக்கலைத் தீர்க்கும் திறன் இல்லை, மேலும் சமூகத்தின் உதவியைப் பெற விரும்புகிறார்கள்.

    • தேவைகள்: உறுதிப்படுத்தல்/மேலும் தகவல்: பிழை உறுதிப்படுத்தல் மற்றும் / அல்லது பாதிக்கப்பட்ட பயனர்களால் மேலும் விவரங்கள் தேவை.

    • தேவைகள்: ஆசிரியரின் கருத்து: மதிப்பாய்வுக்குப் பிறகு ஆசிரியரின் கருத்து தேவைப்படும் ஒன்றிணைப்பு கோரிக்கையைக் கொடியிடப் பயன்படுகிறது. இது ஒரு சிக்கலில் பயன்படுத்தப்படும் தேவைகள்: உறுதிப்படுத்தல்/மேலும் தகவல் என்பதிலிருந்து வேறுபட்டது.

    • தேவைகள்: விவாதம்: இந்த சிக்கலை எவ்வாறு தீர்ப்பது என்பது தெளிவாக இல்லை, மேலும் விவாதம் தேவை.

    • தேவைகள்: மறுசீரமைப்பு: இந்த ஒன்றிணைப்பு கோரிக்கை மறுஅடிப்படையில் இருக்க வேண்டும், ஆனால் மூலக் கிளைக்கு தள்ளுவதற்கு பராமரிப்பாளர்களுக்கு இசைவு இல்லை.

  • கடுமை: சிக்கல் எவ்வளவு தீவிரமானது.
    • கடுமை: முக்கியமான: இந்தப் சிக்கல் மிகவும் கடுமையானது மற்றும் வெளியீட்டின் வெளியீட்டைத் தடுக்க வேண்டும் (அதன் மைல்கல்லால் வரையறுக்கப்படுகிறது).

  • பகுதி: இந்தச் சிக்கல் Ubuntu Touch இன் குறிப்பிட்ட பகுதியுடன் தொடர்புடையது (எ.கா. HAL, மிடில்வேர், UI). இந்த முன்னொட்டுக்கான லேபிள்களை பொருத்தமானதாக உருவாக்கலாம்.

  • தலைப்பு: இந்தச் சிக்கல் குறிப்பிட்ட ஆர்வமுள்ள தலைப்புடன் தொடர்புடையது (எ.கா. VoLTE, தொடர்பு பின்தளத்தில் இடம்பெயர்வு). இந்த முன்னொட்டின் லேபிள்களும் பொருத்தமானதாக உருவாக்கப்படலாம்.

  • தீர்மானம்: சிக்கல் தீர்க்கப்பட்டதைத் தவிர வேறு காரணங்களுக்காக சிக்கல் மூடப்படும்போது பயன்படுத்தப்படுகிறது.
    • தீர்மானம்: உறுதிப்படுத்த முடியவில்லை: சிக்கலை எங்களால் மீண்டும் உருவாக்க முடியவில்லை மற்றும் போதுமான தகவல்கள் வழங்கப்படவில்லை.

    • தீர்மானம்: எங்கள் பிழை அல்ல: சிக்கல் Ubuntu Touch இல் இல்லை, மாறாக பயனரால் நிறுவப்பட்ட மூன்றாம் தரப்பு மென்பொருளில் உள்ள சிக்கலாகும்.

    • தீர்மானம்: சரி செய்யாது: ஒரு பிழை அதை சரிசெய்வதில் அர்த்தமில்லை, ஏனெனில் அது தானாகவே தீர்க்கப்படும், அதிக வேலை, சரிசெய்ய முடியாதது அல்லது அடிப்படை கூறு விரைவில் மாறும்.

    • தீர்மானம்: நோக்கம் கொண்ட வேலை: சிக்கலில் விவரிக்கப்பட்டுள்ள நடத்தை மென்பொருளின் நோக்கம் கொண்ட நடத்தை ஆகும்.

  • Backport இதற்கு: <branch name>: ஒரு MR ஒரு நிலையான வெளியீட்டு கிளைகளுக்கு தானாகவே பேக்போர்ட் செய்ய ஆட்டோமேசனால் பயன்படுத்தப்படுகிறது.

  • இதர லேபிள்கள்
    • நல்ல முதல் சிக்கல்: அறிக்கையில் அதைச் சரிசெய்ய தேவையான வழிமுறைகள் அல்லது குறிப்புகள் உள்ளன. ஒரு உண்மையான சிக்கலைச் சரிசெய்வதன் மூலம் திட்டத்தைப் பற்றி புதிதாக ஒருவர் அறிந்துகொள்ள இது ஒரு சிறந்த இடம்.

    • ஆட்ஃபிக்ச்: இந்த MR/பிரச்சினை Ubuntu Touch இன் புள்ளி வெளியீட்டின் ஒரு பகுதியாக சேர்க்கப்பட்டுள்ளது/தீர்க்கப்பட்டது என வகைப்படுத்துகிறது

Note

ஒரு களஞ்சிய கண்காணிப்பு சிக்கல்கள் உள்நாட்டில் அதன் சொந்த லேபிள்களை வரையறுத்தால், அவை ReadMe.md இல் ஆவணப்படுத்தப்பட வேண்டும்.

Status

Status field is used to indicate the progress of the issue. We've defined the following statuses:

  • New: This is the status for a newly-opened issue. This indicates that this issue is untriaged; Developers and triagers are encouraged to triage issues, assigns kind and other labels, decide whether this issue warrants a milestone, etc. Alternatively, if an issue is a work item, a tracking issue, or something similar filed by developers, this status can be skipped.

  • Ready to be worked on: Indicates that this issue is triaged and can be worked on.

Note

This status replaces default "To do" status.

  • Blocked: Indicates that something else has to be solved outside of this issue before this issue can progress.

  • In progress: Indicates that a developer is actively working on the issue. The issue should be assigned to that developer.

  • Has MR: A non-draft MR exists that will fix this issue.

  • Done: The issue has been fixed in the main branch.

  • Duplicate: The issue is a duplicate. GitLab sets this status automatically when the issue is marked as a duplicate.

  • Won't do: The issue is closed for other reason than the issue being fixed. It should have "Resolution: *" labels to explain the reason (see above).

மைல்கற்கள்

மைல்ச்டோன்கள் எந்த சிக்கலை வெளியிடுகின்றன என்பதை வரையறுக்கப் பயன்படுகின்றன. ஒரு குறிப்பிட்ட நேரத்தில், 3 மைல்கற்கள் வரை திறந்திருக்கும்:

  • வரவிருக்கும் நிலையான வெளியீட்டிற்கான ஒரு மைல்கல் எ.கா. 'உபுண்டு டச் 24.04-1.1'.

  • வளர்ச்சியில் உள்ள முக்கிய வெளியீட்டிற்கான ஒரு மைல்கல் எ.கா. 'உபுண்டு டச் 24.04-2.0'.

  • வளர்ச்சியில் உள்ள வெளியீடு உறுதிப்படுத்தல் கட்டத்தில் நுழைந்தவுடன், அடுத்த பெரிய வெளியீட்டிற்கான மைல்கல்லை உருவாக்கலாம் (எ.கா. 'உபுண்டு டச் 24.04-3.0').

ஒரு மைல்கல்லுக்கு பல சிக்கல்களை ஒதுக்குவதைத் தவிர்க்க உருவாக்குபவர்கள் ஊக்குவிக்கப்படுகிறார்கள்; நிரம்பி வழியும் மைல்கல், வெளியீட்டின் முன்னேற்றத்தைக் கண்காணிப்பதில் மைல்கல்லைப் பயன்படுத்தக்கூடிய அளவிற்குப் பயன்படாமல் செய்கிறது.

ஒதுக்கியவர்கள்

ஒரு சிக்கலில் யார் வேலை செய்கிறார்கள் என்பதை வெளிப்படையாக்க, உருவாக்குபவர் நியமிக்கப்பட வேண்டும். இது GitLab இன் உலகளாவிய வடிகட்டலை ஒரு வகை TODO பட்டியலாக பயன்படுத்த அனுமதிக்கிறது.

உருவாக்குபவர்கள் தங்கள் பட்டியலை குறுகியதாக வைத்திருக்கவும், அவர்களின் சிக்கல்களின் நிலையைப் புதுப்பிக்கவும் ஊக்குவிக்கப்படுகிறார்கள்.

GitLab வெளியீட்டு வாரியம்

We use GitLab's issue boards to visualize progress of issues in each milestone. The boards are kanban boards, where each column corresponds to each defined status (new, ready to be worked on, blocked, in progress, has MR, done, duplicate, won't do).

GitLab காவியம்

ஒற்றை அல்லது பல மைல்கற்கள்/வெளியீடுகளைக் கொண்ட ஒரு தலைப்பைக் குறிக்க GitLab இன் காவியங்களைப் பயன்படுத்துகிறோம். ஒரே நேரத்தில் செயல்படுத்த முடியாத அளவுக்குப் பெரியதாக இருக்கும் சில நீண்ட கால இலக்குகளை ஒழுங்கமைக்க இது உதவுகிறது.

லேபிள்கள், மைல்கல் போன்றவை எவ்வாறு பயன்படுத்தப்படுகின்றன?

லேபிள்கள், மைல்கல் மற்றும் பிற துறைகளை நிருபர், பிற உருவாக்குபவர்கள் மற்றும் ஆர்வமுள்ள தரப்பினருடன் திறமையாக தொடர்புகொள்வதற்கு ஒரு நபர் பயன்படுத்தக்கூடிய கருவிகளாக கருதுங்கள். அவை சில வழிகளில் பயன்படுத்தப்படலாம்:

  • சிக்கல் பட்டியலில் அந்தப் புலங்கள் காட்டப்படுவதால், இது சிக்கலைப் பற்றிய ஒரு பார்வைத் தகவலைத் தருகிறது, உருவாக்குபவர்கள் சிக்கலை விரைவாகப் புரிந்துகொள்ள உதவுகிறது. எடுத்துக்காட்டாக, ஒரு உருவாக்குபவர் பட்டியலில் உள்ள சிக்கலைப் பார்த்து, அந்தச் சிக்கலுக்கு "கலந்துரையாட வேண்டும்" என்ற சிட்டை இருப்பதைக் கவனித்து, 2 சென்ட்களை வழங்க முடிவு செய்யலாம்.

  • ஆர்வமுள்ள சிக்கல்களை மட்டும் வடிகட்ட ஒரு புலத்தைப் பயன்படுத்தலாம். எடுத்துக்காட்டாக, சிக்கல்களை உறுதிப்படுத்துவதில் பங்களிக்க விரும்பும் ஒரு சமூக உறுப்பினர் "உறுதிப்படுத்தல் தேவை" என்ற லேபிளில் உள்ள சிக்கல்களை மட்டுமே வடிகட்ட முடியும்.

  • ஆர்வமற்ற சிக்கல்களை வடிகட்ட ஒரு புலம் பயன்படுத்தப்படலாம். எடுத்துக்காட்டாக, உருவாக்குபவர் ஒரு சிக்கலைத் தீர்க்க விரும்பினால், ஒருவர் "வகை: செயல்முறை" லேபிளை வடிகட்ட விரும்புவார் (எ.கா. வெளியீட்டிற்கான கண்காணிப்பு சிக்கலுக்குப் பயன்படுத்தப்படுகிறது).

எங்களிடம் எப்பொழுதும் குறிப்பாகச் சிக்கல்களைச் சரிபார்த்து, அந்த லேபிள்களை அமைக்க யாரும் இல்லாததால், உருவாக்குபவர்கள் ஒரு சிக்கலில் பணிபுரியும் போது அந்தத் துறைகள் அனைத்தையும் அமைக்க ஊக்குவிக்கப்படுகிறார்கள். இது சிக்கலில் என்ன செய்யப்பட்டுள்ளது என்பதைத் தொடர்புகொள்ள உதவும், மேலும் சிக்கலை விரைவாகப் புரிந்துகொள்வதற்கும் இது உதவும்.