Re: [Snowdrift-dev] What are the folders to purge to fix or prevent build issues?

2016-05-09 Thread Victor Grousset
On 08/05/2016 21:45, Bryan Richter wrote:
> On Sat, May 07, 2016 at 02:15:22PM +0200, Victor/tuxayo wrote:
>> What about adding this as a "Manual rebuild" sub section? Just after
>> "Updating static files":
>> https://git.snowdrift.coop/sd/snowdrift/blob/master/BUILD.md#updating-static-files
> 
> There's a "manual rebuild" section right *before*
> updating-static-files. :) You could add some content to that section,
> however (and maybe that's what you meant).

Updating-static-files is a subsection of manual rebuild. That why I
wanted to put it after. But if it makes more sense before, no problem.

Right I'll try to write something (until I manage to fix my RAM
stability issues...)


-- 
Victor Grousset
___
Dev mailing list
Dev@lists.snowdrift.coop
https://lists.snowdrift.coop/mailman/listinfo/dev


Re: [Snowdrift-dev] What are the folders to purge to fix or prevent build issues?

2016-05-08 Thread Bryan Richter
On Sat, May 07, 2016 at 02:15:22PM +0200, Victor/tuxayo wrote:
> On 06/05/2016 19:44, Aaron Wolf wrote:
> > While this stuff about purging is documented at the Stack docs and
> > otherwise, I could see adding to BUILD a statement referencing that the
> > total list of things to possibly purge includes `sdb.hs clean` and
> > purging .stack-work and then ~/.stack and, of course, the project
> > directory itself (and, I guess finally: whatever system things were
> > installed). I'm not sure that's needed, but it's nice to have a full
> > list of "things affected by building and running this"…
> 
> What about adding this as a "Manual rebuild" sub section? Just after
> "Updating static files":
> https://git.snowdrift.coop/sd/snowdrift/blob/master/BUILD.md#updating-static-files

There's a "manual rebuild" section right *before*
updating-static-files. :) You could add some content to that section,
however (and maybe that's what you meant).


signature.asc
Description: Digital signature
___
Dev mailing list
Dev@lists.snowdrift.coop
https://lists.snowdrift.coop/mailman/listinfo/dev


Re: [Snowdrift-dev] What are the folders to purge to fix or prevent build issues?

2016-05-07 Thread Victor/tuxayo
On 06/05/2016 17:48, Bryan Richter wrote:
> Perhaps we should wait to see if it is frequently asked. :)

Has anyone except me and my horribly unstable environment ever needed to
purge build files?


> We can put in a link to http://haskellstack.org in the docs, if we
> haven't already. Honestly I'm not sure where it should go, however. I
> have trouble keeping BUILD/README/CONTRIBUTING straight. Aaron?

Indeed, what I initially asked was on the stack FAQ
http://docs.haskellstack.org/en/stable/faq/?highlight=.stack-work#how-do-i-reset-remove-stack-such-as-to-to-do-a-completely-fresh-build


On 06/05/2016 19:44, Aaron Wolf wrote:
> While this stuff about purging is documented at the Stack docs and
> otherwise, I could see adding to BUILD a statement referencing that the
> total list of things to possibly purge includes `sdb.hs clean` and
> purging .stack-work and then ~/.stack and, of course, the project
> directory itself (and, I guess finally: whatever system things were
> installed). I'm not sure that's needed, but it's nice to have a full
> list of "things affected by building and running this"…

What about adding this as a "Manual rebuild" sub section? Just after
"Updating static files":
https://git.snowdrift.coop/sd/snowdrift/blob/master/BUILD.md#updating-static-files



Cheers,

-- 
Victor/tuxayo
___
Dev mailing list
Dev@lists.snowdrift.coop
https://lists.snowdrift.coop/mailman/listinfo/dev


Re: [Snowdrift-dev] What are the folders to purge to fix or prevent build issues?

2016-05-06 Thread Aaron Wolf
On 05/06/2016 08:48 AM, Bryan Richter wrote:
> On Fri, May 06, 2016 at 01:09:10PM +0200, Victor Grousset wrote:
>> On 04/05/2016 19:48, Aaron Wolf wrote:
>>> There are no other directories to purge unless you already ran the site
>>> and have database stuff to deal with. To clean out database stuff, it's
>>> better to use the sdb.hs tool rather than manually clean things though.
>>>
>>> although it shouldn't cause any troubles if you stopped in the middle of
>>> a build or anything. Purging shouldn't be needed…
>>
>> Few month ago I also crashed during a build(I still haven't fixed my
>> stability issues...) and had to purge at least .stack-work to be able to
>> build.
>>
>>
>>> $PROJECT_ROOT/.stack-work should always be purged first when purging
>>>
>>> ~/.stack should never need purging per se, but for cleanliness or to be
>>> just certain, it can be purged, but it should be purged along with or
>>> after the purge of $PROJECT_ROOT/.stack-work
>>
>> Thanks for all the info, is there a wiki page or a file in the
>> repository where I could document that?
>> (a dev FAQ or something)
> 
> Perhaps we should wait to see if it is frequently asked. :)
> 
> We can put in a link to http://haskellstack.org in the docs, if we
> haven't already. Honestly I'm not sure where it should go, however. I
> have trouble keeping BUILD/README/CONTRIBUTING straight. Aaron?
> 
> 

README: the stuff you see automatically on the repo, includes links to
other files and descriptions, basic summary

CONTRIBUTING: full everything for contributors, links to educational
stuff, how we use git, how to get started from zero, etc.

BUILD: the core things that are the minimum of "do this stuff to build
and run the site". This is stuff even an experienced Haskeller would
want to check to verify our exact steps. It's the way to build and run
while skipping all other meta stuff about contributing. CONTRIBUTING
links to BUILD when it comes to the stage of contributing where one
actually would build and run.

While this stuff about purging is documented at the Stack docs and
otherwise, I could see adding to BUILD a statement referencing that the
total list of things to possibly purge includes `sdb.hs clean` and
purging .stack-work and then ~/.stack and, of course, the project
directory itself (and, I guess finally: whatever system things were
installed). I'm not sure that's needed, but it's nice to have a full
list of "things affected by building and running this"…




signature.asc
Description: OpenPGP digital signature
___
Dev mailing list
Dev@lists.snowdrift.coop
https://lists.snowdrift.coop/mailman/listinfo/dev


Re: [Snowdrift-dev] What are the folders to purge to fix or prevent build issues?

2016-05-06 Thread Bryan Richter
On Fri, May 06, 2016 at 01:09:10PM +0200, Victor Grousset wrote:
> On 04/05/2016 19:48, Aaron Wolf wrote:
> > There are no other directories to purge unless you already ran the site
> > and have database stuff to deal with. To clean out database stuff, it's
> > better to use the sdb.hs tool rather than manually clean things though.
> > 
> > although it shouldn't cause any troubles if you stopped in the middle of
> > a build or anything. Purging shouldn't be needed…
> 
> Few month ago I also crashed during a build(I still haven't fixed my
> stability issues...) and had to purge at least .stack-work to be able to
> build.
> 
> 
> > $PROJECT_ROOT/.stack-work should always be purged first when purging
> > 
> > ~/.stack should never need purging per se, but for cleanliness or to be
> > just certain, it can be purged, but it should be purged along with or
> > after the purge of $PROJECT_ROOT/.stack-work
> 
> Thanks for all the info, is there a wiki page or a file in the
> repository where I could document that?
> (a dev FAQ or something)

Perhaps we should wait to see if it is frequently asked. :)

We can put in a link to http://haskellstack.org in the docs, if we
haven't already. Honestly I'm not sure where it should go, however. I
have trouble keeping BUILD/README/CONTRIBUTING straight. Aaron?


signature.asc
Description: Digital signature
___
Dev mailing list
Dev@lists.snowdrift.coop
https://lists.snowdrift.coop/mailman/listinfo/dev


Re: [Snowdrift-dev] What are the folders to purge to fix or prevent build issues?

2016-05-06 Thread Victor Grousset
On 04/05/2016 19:48, Aaron Wolf wrote:
> There are no other directories to purge unless you already ran the site
> and have database stuff to deal with. To clean out database stuff, it's
> better to use the sdb.hs tool rather than manually clean things though.
> 
> although it shouldn't cause any troubles if you stopped in the middle of
> a build or anything. Purging shouldn't be needed…

Few month ago I also crashed during a build(I still haven't fixed my
stability issues...) and had to purge at least .stack-work to be able to
build.


> $PROJECT_ROOT/.stack-work should always be purged first when purging
> 
> ~/.stack should never need purging per se, but for cleanliness or to be
> just certain, it can be purged, but it should be purged along with or
> after the purge of $PROJECT_ROOT/.stack-work

Thanks for all the info, is there a wiki page or a file in the
repository where I could document that?
(a dev FAQ or something)


-- 
Victor Grousset
___
Dev mailing list
Dev@lists.snowdrift.coop
https://lists.snowdrift.coop/mailman/listinfo/dev


Re: [Snowdrift-dev] What are the folders to purge to fix or prevent build issues?

2016-05-04 Thread Aaron Wolf
On 05/04/2016 04:41 AM, Victor/tuxayo wrote:
> Hi,
> 
> My computer crashed during the build of the project and I would like to
> clean the potential mess left.
> 
> I remember at least two folders that I needed to purge during past build
> issues:
> - $PROJECT_ROOT/.stack-work
> - ~/.stack
> 
> Are there any other folders to remove to come back to a *full* clean
> state? (Also useful after few months of new dependency versions/heavy
> refactor to save disk space)
> 
> And what is the priority in purging those folders when having a build
> issue? For example:
> - `.stack-work` first and if there are still issues `~/.stack`
> - always purge both at the same time
> 
> 
> 
> Cheers,
> 

There are no other directories to purge unless you already ran the site
and have database stuff to deal with. To clean out database stuff, it's
better to use the sdb.hs tool rather than manually clean things though.

although it shouldn't cause any troubles if you stopped in the middle of
a build or anything. Purging shouldn't be needed…

$PROJECT_ROOT/.stack-work should always be purged first when purging

~/.stack should never need purging per se, but for cleanliness or to be
just certain, it can be purged, but it should be purged along with or
after the purge of $PROJECT_ROOT/.stack-work

That's it really




signature.asc
Description: OpenPGP digital signature
___
Dev mailing list
Dev@lists.snowdrift.coop
https://lists.snowdrift.coop/mailman/listinfo/dev